HD Wallets Management
Manage a wallet from its xPub, yPub or zPub, the extended public key only. Sync it once, derive receiving and change addresses, and read the whole wallet's balance, assets, transactions and UTXOs.
Wallet infrastructure without holding keys
A fresh address per customer
Derive and sync a new receiving address for every deposit from the extended public key alone, with no private key involved.
One balance for many addresses
Read the total balance, assets and transactions of every address the wallet has used, instead of adding them up yourself.
Spend from the wallet
Prepare a transaction from the wallet's funds on UTXO and EVM chains, then sign it on your own server.
Make your first HD Wallets Management call
Real paths and example responses from the API reference. Add your API key and run it.
- Base URL
https://rest.cryptoapis.io - Auth: the X-API-Key header
- JSON responses, same shape on every chain
curl -X POST https://rest.cryptoapis.io/hd-wallets/manage/ethereum/mainnet/EXTENDED_PUBLIC_KEY/sync \ -H "X-API-Key: YOUR_API_KEY"
{
"extendedPublicKey": "upub5Ei6bRNneqozk6smK7dvtXHC5PjUyEL4ynCf…"
}
curl https://rest.cryptoapis.io/hd-wallets/utxo/bitcoin/mainnet/EXTENDED_PUBLIC_KEY/details \ -H "X-API-Key: YOUR_API_KEY"
{
"confirmedBalance": "0.0021",
"unit": "BTC",
"totalReceived": "0.0002",
"totalSpent": "0.0001"
}
curl -X POST https://rest.cryptoapis.io/hd-wallets/utxo/bitcoin/mainnet/EXTENDED_PUBLIC_KEY/addresses/derive-and-sync \ -H "X-API-Key: YOUR_API_KEY"
{
"limit": 50,
"offset": 0,
"total": 100,
"items": [
{
"address": "0x5050F69a9786F081509234F1a7F4684b5E5b76C9",
"format": "P2WPKH",
"index": 1,
"derivationType": "bip32"
}
]
}
Every HD Wallets Management endpoint
Each operation links to its page in the API reference, with its parameters and responses. Paths take the blockchain and the network, so moving to another chain is a change of path.
/hd-wallets/manage/{blockchain}/{network}/hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}/hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}/activate/hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}/status/hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}/sync/hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/addresses/hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync/hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/assets/hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/details/hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/transactions/hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/transactions/prepare/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/addresses/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync-change/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/assets/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/details/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/transactions/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/transactions/prepare/hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/unspent-outputs/hd-wallets/{blockchain}/{network}/{extendedPublicKey}/addresses/hd-wallets/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync/hd-wallets/{blockchain}/{network}/{extendedPublicKey}/assets/hd-wallets/{blockchain}/{network}/{extendedPublicKey}/details/hd-wallets/{blockchain}/{network}/{extendedPublicKey}/transactionsHD Wallets Management works on 11 blockchains
Mainnets, and test networks where the chain has one. Open a chain for its own endpoints and quick start.
HD Wallets Management questions
Which blockchains does HD Wallets Management support?
HD Wallets Management works on 11 blockchains: Bitcoin, Ethereum, XRP Ledger, Ethereum Classic, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash, BNB Smart Chain, Tron. Each chain's page lists its networks and its own endpoints.
Can I try HD Wallets Management for free?
Yes, for 14 days. The Blockchain API free trial includes HD Wallets Management and every other feature, with no card. It ends after 14 days or when its credits run out; after that, calls need a subscription, listed on the pricing page.
Does the HD Wallets Management API support Solana?
No. HD wallet (xPub/yPub/zPub) sync is not available for Solana. HD wallet coverage is limited to the EVM chains Ethereum, Ethereum Classic, BNB Smart Chain and Tron, the six UTXO chains (Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash, Zcash) and XRP. Solana is supported by other Crypto APIs products such as transactions data and blockchain events, but not by the HD wallet endpoints.
What can I do with a synced xPub through the HD Wallets API?
Once you sync an extended public key you can list all your synced HD wallets, pull the wallet's aggregated assets and balances, retrieve wallet details, and list the wallet's transactions across all derived addresses through a single integration. The sync monitors every derived address for you, so you do not have to track individual addresses manually. Syncing and deleting an xPub each carry a subscription cost, and monitored addresses incur a daily monitoring tax.
Can I derive addresses from an xPub without calling the API or exposing keys?
Yes. Crypto APIs provides address-derivation utilities in the blockchain tools family that generate child addresses from an extended public key for EVM chains, the UTXO chains and XRP. Because HD wallets use extended public keys, derivation and wallet syncing never require your private keys. This lets you generate deposit addresses and reconcile them against a synced wallet.
Start building with HD Wallets Management
14-day free trial, mainnet included. No card needed.