# 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.

- Public keys only
- xPub, yPub and zPub
- Prepare from the whole wallet

## Key facts

| | |
| --- | --- |
| Endpoints | 24 |
| Blockchains | 11 |
| Chain families | EVM, UTXO, XRP |
| Custody | Non-custodial, you sign |
| Free trial | 14 days, no card |

## 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.

### Sync an xPub

```
curl -X POST https://rest.cryptoapis.io/hd-wallets/manage/ethereum/mainnet/EXTENDED_PUBLIC_KEY/sync \
  -H "X-API-Key: YOUR_API_KEY"
```

### Wallet details · UTXO

```
curl https://rest.cryptoapis.io/hd-wallets/utxo/bitcoin/mainnet/EXTENDED_PUBLIC_KEY/details \
  -H "X-API-Key: YOUR_API_KEY"
```

### New address · UTXO

```
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"
```

## 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.

| What it does | Method and path | Blockchains | Reference |
| --- | --- | --- | --- |
| List Synced HD Wallets (xPub, yPub, zPub) | `GET /hd-wallets/manage/{blockchain}/{network}` | Bitcoin, Ethereum, XRP Ledger, Ethereum Classic, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/manage-hd-wallet/list-synced-hd-wallets-xpub-ypub-zpub/get) |
| Delete Synced HD Wallet (xPub, yPub, zPub) | `DELETE /hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}` | Bitcoin, Ethereum, XRP Ledger, Ethereum Classic, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/manage-hd-wallet/delete-synced-hd-wallet-xpub-ypub-zpub/delete) |
| Activate HD Wallet (xPub, yPub, zPub) | `POST /hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}/activate` | Bitcoin, Ethereum, XRP Ledger, Ethereum Classic, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/manage-hd-wallet/activate-hd-wallet-xpub-ypub-zpub/post) |
| Get HD Wallet Status  (xPub, yPub, zPub) | `GET /hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}/status` | Bitcoin, Ethereum, XRP Ledger, Ethereum Classic, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/manage-hd-wallet/get-hd-wallet-status-xpub-ypub-zpub/get) |
| Sync HD Wallet (xPub, yPub, zPub) | `POST /hd-wallets/manage/{blockchain}/{network}/{extendedPublicKey}/sync` | Bitcoin, Ethereum, XRP Ledger, Ethereum Classic, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/manage-hd-wallet/sync-hd-wallet-xpub-ypub-zpub/post) |
| List Synced Addresses EVM | `GET /hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/addresses` | Ethereum, Ethereum Classic, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-evm/list-synced-addresses-evm/get) |
| Derive And Sync New Receiving Addresses EVM | `POST /hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync` | Ethereum, Ethereum Classic, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-evm/derive-and-sync-new-receiving-addresses-evm/post) |
| Get HD Wallet (xPub, yPub, zPub) Assets EVM | `GET /hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/assets` | Ethereum, Ethereum Classic, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-evm/get-hd-wallet-xpub-ypub-zpub-assets-evm/get) |
| Get HD Wallet (xPub, yPub, zPub) Details EVM | `GET /hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/details` | Ethereum, Ethereum Classic, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-evm/get-hd-wallet-xpub-ypub-zpub-details-evm/get) |
| List HD Wallet (xPub, yPub, zPub) Transactions EVM | `GET /hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/transactions` | Ethereum, Ethereum Classic, BNB Smart Chain, Tron | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-evm/list-hd-wallet-xpub-ypub-zpub-transactions-evm/get) |
| Prepare A Transaction From an Address in HD Wallet (xPub, yPub, zPub) EVM | `POST /hd-wallets/evm/{blockchain}/{network}/{extendedPublicKey}/transactions/prepare` | Ethereum, Ethereum Classic, BNB Smart Chain | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-evm/prepare-a-transaction-from-an-address-in-hd-wallet-xpub-ypub-zpub-evm/post) |
| List Synced Addresses UTXO | `GET /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/addresses` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/list-synced-addresses-utxo/get) |
| Derive And Sync New Receiving Addresses UTXO | `POST /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/derive-and-sync-new-receiving-addresses-utxo/post) |
| Derive And Sync New Change Addresses UTXO | `POST /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync-change` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/derive-and-sync-new-change-addresses-utxo/post) |
| Get HD Wallet (xPub, yPub, zPub) Assets UTXO | `GET /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/assets` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/get-hd-wallet-xpub-ypub-zpub-assets-utxo/get) |
| Get HD Wallet (xPub, yPub, zPub) Details UTXO | `GET /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/details` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/get-hd-wallet-xpub-ypub-zpub-details-utxo/get) |
| List HD Wallet (xPub, yPub, zPub) Transactions UTXO | `GET /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/transactions` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/list-hd-wallet-xpub-ypub-zpub-transactions-utxo/get) |
| Prepare A UTXO-Based Transaction From HD Wallet (xPub, yPub, zPub) | `POST /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/transactions/prepare` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/prepare-a-utxo-based-transaction-from-hd-wallet-xpub-ypub-zpub/post) |
| List HD Wallet (xPub, yPub, zPub) UTXOs | `GET /hd-wallets/utxo/{blockchain}/{network}/{extendedPublicKey}/unspent-outputs` | Bitcoin, Bitcoin Cash, Dash, Litecoin, Dogecoin, Zcash | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-utxo/list-hd-wallet-xpub-ypub-zpub-utxos/get) |
| List Synced Addresses XRP | `GET /hd-wallets/{blockchain}/{network}/{extendedPublicKey}/addresses` | XRP Ledger | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-xrp/list-synced-addresses-xrp/get) |
| Derive And Sync New Receiving Addresses XRP | `POST /hd-wallets/{blockchain}/{network}/{extendedPublicKey}/addresses/derive-and-sync` | XRP Ledger | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-xrp/derive-and-sync-new-receiving-addresses-xrp/post) |
| Get HD Wallet (xPub, yPub, zPub) Assets XRP | `GET /hd-wallets/{blockchain}/{network}/{extendedPublicKey}/assets` | XRP Ledger | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-xrp/get-hd-wallet-xpub-ypub-zpub-assets-xrp/get) |
| Get HD Wallet (xPub, yPub, zPub) Details XRP | `GET /hd-wallets/{blockchain}/{network}/{extendedPublicKey}/details` | XRP Ledger | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-xrp/get-hd-wallet-xpub-ypub-zpub-details-xrp/get) |
| List HD Wallet (xPub, yPub, zPub) Transactions XRP | `GET /hd-wallets/{blockchain}/{network}/{extendedPublicKey}/transactions` | XRP Ledger | [Docs](https://developers.cryptoapis.io/v-2.2024-12-12-175/RESTapis/hd-wallet-data-xrp/list-hd-wallet-xpub-ypub-zpub-transactions-xrp/get) |

## HD 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.

- [Bitcoin](/chains/bitcoin)
- [Ethereum](/chains/ethereum)
- [XRP Ledger](/chains/ripple)
- [Ethereum Classic](/chains/ethereum-classic)
- [Bitcoin Cash](/chains/bitcoin-cash)
- [Dash](/chains/dash)
- [Litecoin](/chains/litecoin)
- [Dogecoin](/chains/doge)
- [Zcash](/chains/zcash)
- [BNB Smart Chain](/chains/binance-smart-chain)
- [Tron](/chains/tron)

## Build the rest of the flow

- [Blockchain Utils](/products/blockchain-api/blockchain-utils) — Validate, decode, derive and convert
- [Prepare Transactions](/products/blockchain-api/prepare-transactions) — Unsigned transactions, ready to sign on your server
- [Blockchain Events](/products/blockchain-api/blockchain-events) — Webhooks when a transaction confirms or a block is mined

## 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](/pricing).

**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.

## Pointers

- [Blockchain API](/products/blockchain-api)
- [All networks](/what-we-support)
- [Pricing](/pricing)
- [Developer portal](https://developers.cryptoapis.io/)