Create address
Derives an address for the wallet. Account-based chains (Ethereum / EVM L2s, Solana, Tron, TON) hold exactly one address per wallet — repeated calls with an asset_id on the same chain return the existing primary (with X-Idempotent-Replayed: true). Bitcoin permits multiple addresses, so each call derives a new one.
Authorizations
Headers
API version (defaults to the latest supported version if omitted).
v1 Unique key (1-255 printable ASCII chars) used to safely retry write operations. Same key + body returns the cached response; same key + different body returns 409.
1 - 255Path Parameters
Wallet ID
Body
Bitcoin address format: p2wpkh (default), p2tr, or p2pkh; ignored on account-based chains
p2wpkh, p2tr, p2pkh "p2wpkh"
Optional partner-facing label stored on the address record
"Customer deposits"
Deprecated. The environment determines the network (live→mainnet, sandbox→testnet); an omitted value defaults to the wallet's network. Ignored when it contradicts the environment.
"mainnet"
Response
Created
On-chain address string
"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
Blockchain the address belongs to
"ethereum"
ISO-8601 timestamp when the address was created
"2026-05-16T10:30:00Z"
Address format (e.g. p2wpkh, p2tr, p2pkh for Bitcoin)
Unique identifier of the address record
"3f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
Whether this is the wallet's primary receive address
true
Optional partner-facing label for the address
"Customer deposits"
Network the address is on (e.g. mainnet)
"mainnet"
Object type, always "address"
"address"
Identifier of the wallet this address belongs to
"a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"