Admin Login
HomeGuidesAPI ReferenceChangelogBlockdaemon Main Docs
Log In
Guides

Deposit Addresses

Omnibus deposit addresses, funding, and consolidation

Deposit addresses

One account can hold more than the main address. Each extra address is the next index under that account. Client deposits can land on those addresses while policy, approvals, and the audit log stay on the account.

Additional indexes are supported on Bitcoin, EVM, Solana, and Stellar. In the wallet UI, EVM deposit addresses require the omnibus feature.

Create, fund, and consolidate through the Vault API. Pass the API key in the authorization header with no Bearer prefix.

Create a deposit address

POST /api/cwp/addresses/new allocates the next index for the CAIP-19 and returns the address.

curl -s -X POST "https://<wallet-host>/api/cwp/addresses/new" \
  -H "authorization: <api-key>" \
  -H "content-type: application/json" \
  -d '{
    "MasterKey": "default",
    "Account": "deposits",
    "CAIP19": "eip155:1/slip44:60",
    "Label": "client-acme"
  }'

The response includes the new address and its index. Tokens on the same chain share that address. A label is optional display text. Signing and transaction restrictions use the account name, not the label.

Index 0 is the main address. The next successful call receives the next index.

Fund deposit addresses

POST /api/cwp/operations/start/fundSubaddresses moves value from the main address to one or more indexes in a single operation. Each entry names an index and an amount in base units.

curl -s -X POST "https://<wallet-host>/api/cwp/operations/start/fundSubaddresses" \
  -H "authorization: <api-key>" \
  -H "content-type: application/json" \
  -d '{
    "OperationID": "fund-deposits-1",
    "CAIP19": "eip155:1/slip44:60",
    "Asset": "ETH",
    "MasterKeyName": "default",
    "Account": "deposits",
    "SubAddressesFunding": [
      { "Index": 1, "Amount": "10000000000000000" },
      { "Index": 2, "Amount": "20000000000000000" }
    ]
  }'

Track the operation with operation submission and status. The operation follows transaction restrictions.

Consolidate to the main address

POST /api/cwp/operations/start/consolidateFunds moves a balance from one deposit index back to the main address. On EVM, the deposit address pays its own network fee, so that address needs a native-gas balance.

curl -s -X POST "https://<wallet-host>/api/cwp/operations/start/consolidateFunds" \
  -H "authorization: <api-key>" \
  -H "content-type: application/json" \
  -d '{
    "OperationID": "consolidate-1",
    "CAIP19": "eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "Asset": "USDC",
    "MasterKeyName": "default",
    "Account": "deposits",
    "SubAddressIndex": 1,
    "Amount": "25000000"
  }'

To sweep EVM deposit addresses that hold no native gas, use gas-sponsored transactions. That flow pays the fee from a sponsor account.

🗣️We Are Here to Help!

Please contact us via email or support chat if you encounter an issue, bug, or need assistance. Don't forget to include any relevant details about the problem. To request a wallet form and Institutional Vault Approver form, please click here or contact our sales team.


Did this page help you?