Skip to main content
GET
Get wallet balances across all networks

Authorizations

x-api-key
string
header
required

Path Parameters

wallet_id
string
required

Wallet ID KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Response

Wallet balances retrieved successfully

Balances for a wallet address across all networks

wallet_id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

address
string
required

The wallet address

Example:

"0x165cd37b4c644c2921454429e7f9358d18a45e14"

balances
object[]
required

List of asset balances

total_amount_usd
string
required

Total USD value of all balances, as a decimal string with 2 decimal places (cents). Rounded DOWN (truncated toward zero), never rounded up, so the value never exceeds the holder's spendable balance.

Example:

"1234.56"

card
Wallet Card Balance · object

Sandbox only. Cards is available in sandbox only while we finish development, so production responses never include card.

The spendable position of the wallet's cards, read live from the card provider. Present while the wallet's card enablement is active, detach_requested or detached, since a wallet being detached, or already detached, can still owe an outstanding amount. Absent (never null) for a wallet with no enablement or one still attaching. Also absent when the card position cannot be read within a short time budget: the rest of the response does not depend on it, so a slow or failed card read never fails or delays the balances call. Every other field is the same whether or not card is present.