GET
Get a 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.

Path Parameters

reference
string
required

Your reference for the wallet, or its id.

Query Parameters

network
enum<string>
required

The network the data lives on. Required — there is no default network: without it, 422 network_required. A wallet named by its id on another network: 422 network_mismatch.

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

Response

The wallet.

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