Skip to main content
The Addresses API lets you generate dedicated deposit addresses for each of your users. Each address is a child of your master wallet and inherits its network and asset configuration.

What you can do

  • Generate a new deposit address for a user
  • Retrieve address details, balances, and transaction history
  • Update address metadata
  • Whitelist or unwhitelist addresses for withdrawal

Key concepts

One address per user. Never reuse addresses across users. Each address should be permanently assigned to one user so deposits can be attributed correctly. EVM compatibility. On EVM-compatible chains, a single address works across all supported EVM networks.

Endpoints

MethodEndpointDescription
GET/wallets/{walletId}/addressesList all addresses
POST/wallets/{walletId}/addressesGenerate a new address
GET/wallets/{walletId}/addresses/{addressId}Get address details
PATCH/wallets/{walletId}/addresses/{addressId}Update address metadata
POST/wallets/{walletId}/addresses/{addressId}/whitelistWhitelist an address
DELETE/wallets/{walletId}/addresses/{addressId}/whitelistUnwhitelist an address
GET/wallets/{walletId}/addresses/{addressId}/balanceGet single asset balance
GET/wallets/{walletId}/addresses/{addressId}/balancesGet all asset balances
GET/wallets/{walletId}/addresses/{addressId}/transactionsList transactions

Full API Reference

View all address endpoints in the API Reference tab.