Bitcoin wallet API for business
Run Bitcoin wallets for your business without handing anyone your keys. Guveno gives every customer or payer their own deposit address, tells your systems when bitcoin arrives, and builds withdrawals that you sign on your own machine.
Bitcoin at a glance
- Native coin
- BTC
- Networks
- Mainnet, Testnet
- Listed tokens
- None, native coin only
- Addresses
- Native SegWit (bc1q…, P2WPKH) addresses, derived at m/84'/0'/0'/0 by default (m/84'/1'/0'/0 on testnet).
- Confirmed after
- 2 confirmations by default
- Plans
- Testnet on every plan, including the free Developer tier. Mainnet on Startup, Pro and Enterprise.
How Bitcoin deposits are credited
Guveno watches each address for outputs paying it. A deposit can be reported as pending straight from the mempool, with zero confirmations, so you can show it to a customer early; it is confirmed, and safe to credit, once its block is buried under the confirmation depth.
If a pending deposit is replaced or dropped before it is mined, you get a deposit.rejected event so you can reverse anything you showed early.
Each deposit reaches you as a webhook: deposit.detected while it is pending, then deposit.confirmed with the exact amount delivered, which is the signal to credit it.
Sending BTC
Withdrawals gather unspent outputs from across the wallet and return change to an address the wallet owns. To keep funds segregated, name the source addresses yourself.
Every withdrawal is prepared by the API, signed with key material only you hold, and broadcast once. A send whose outcome is unknown is never retried blind. See withdrawals and hot wallets for automated payouts.
List your Bitcoin wallets
curl "https://api.guveno.com/v1/wallets?chain=bitcoin&network=testnet" \
-H "Authorization: Bearer gv_live_your_key_here"Wallets are created from the dashboard, the Node.js or Python SDK, or the CLI, so the recovery phrase is generated and encrypted on your side.
Bitcoin questions
Which Bitcoin assets does Guveno support?
Guveno supports BTC, the native coin. There are no Bitcoin tokens on the list today.
When is a Bitcoin deposit confirmed?
2 confirmations by default. Until then the deposit is reported as pending, and you should not credit it.
Which plans include Bitcoin?
Testnet on every plan, including the free Developer tier. Mainnet on Startup, Pro and Enterprise.
Does Guveno hold my Bitcoin keys?
No. Guveno is self-custodial: your recovery phrase is encrypted on your device, and Guveno never holds a key that can move your funds. It watches your addresses and prepares transactions, and you sign them.