POST
Issue a deposit wallet

Authorizations

Authorization
string
header
required

An API key minted in the console (ctd_…). Authenticates; never authorizes funds. A key carries scopes (read, wallets.write, transactions.write, events.write, webhooks.write, policy.write) and may be limited to vaults, to IP addresses, and in lifetime — see Authentication.

Body

application/json
reference
string
required

Your id for the wallet; unique per network.

chain
enum<string>
required
Available options:
tron,
evm,
solana,
ton
network
enum<string>
required

The network the data lives on. Required wherever it appears in a request — there is no default network. One your installation does not serve: 422 network_not_served.

Available options:
mainnet,
testnet
end_user_ref
string
required

Your user the wallet belongs to. Missing or empty: 422.

Minimum string length: 1
label
string
default:deposit
tags
string[]
vault
string<uuid>

Which vault; absent — the oldest vault the key reaches. Outside the key's vaults: 422.

account_implementation
string

EVM smart-account implementation id.

Response

A wallet with this reference already exists on this network.

id
string<uuid>
required
reference
string
required
chain
enum<string>
required
Available options:
tron,
evm,
solana,
ton
network
enum<string>
required

The network the data lives on. Required wherever it appears in a request — there is no default network. One your installation does not serve: 422 network_not_served.

Available options:
mainnet,
testnet
status
enum<string>
required

creating — issued, your signer has not derived it yet; active — in circulation; retired — out of circulation (POST /wallets/{reference}/retire): still watched, credited, and able to send; failed — your signer could not derive it, it has no address.

Available options:
creating,
active,
retired,
failed
created_at
string<date-time>
required
address
string

Absent while creating, and on a failed wallet.

label
string
tags
string[]
end_user_ref
string
vault
string<uuid>

The vault the wallet is in.

account_implementation
string