Boltz Docs
API: Boltz Backend
Comment on page


Boltz exposes a RESTful HTTP API that can be used to query information like supported pairs as well as to create and monitor swaps.


We offer Boltz on testnet for development & testing purposes and our production service on mainnet.
The corresponding REST APIs can be accessed at:
  • Testnet:
  • Mainnet:
  • Mainnet via Tor: http://boltzzzbnus4m7mta3cxmflnps4fp7dueu2tgurstbvrbt6xswzcocyd.onion/api/
Note: To test API accessibility via browser, simply append an endpoint to the address, e.g.:
In the following sections we'll walk through existing swap types & states, describe the REST API, how to handle refunds and more.
Last modified 1mo ago