I have a docker instance running a bitcoin node and would like to listen to deposits, generating a new address each time a user requests to deposit then increment the users account balance on success.

  • 1
    Hey, this looks like you are in need of PoS software, as you'd have to implement a lot on top of bitcoin core to achieve this. You can look into btcpay server which is free OS PoS on top of bitcoin core?
    – Tony Sanak
    May 29, 2020 at 14:08

2 Answers 2


Bitcoin has walletnotify feature that will notify you when an address you own in your wallet receives a transaction, and a second notification when the transaction confirms.

You can set it in your bitcoin.conf

walletnotify= curl http://yoururl.com/endpoint.php?tx=%s

%s will contain the transaction id. What you do from there is up to you.


Apart from walletnotify callback these are the JSON RPC calls that you would use:

For these calls to work, you need to have a corresponding wallet created or imported into Bitcoin Core. It is also a good idea to set txindex=1 so you can add pre-existing wallets to Core add hoc.

PS Depending on your specific use case it may be better to use existing open source, self hosted solutions like legendary BTCPay Server or more recent CypherpunkPay (disclosure: the author).

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.