Skip to main content
GET
/
wallets
/
{wallet_id}
/
balances
Get wallet balances across all networks
curl --request GET \
  --url https://api.platform.dakota.xyz/wallets/{wallet_id}/balances \
  --header 'x-api-key: <api-key>'
{
  "wallet_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "address": "0x165cd37b4c644c2921454429e7f9358d18a45e14",
  "balances": [
    {
      "asset": {
        "id": "USDC",
        "name": "USD Coin",
        "network_id": "ethereum-mainnet",
        "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "token_standard": "erc20",
        "decimals": 6
      },
      "amount_usd": "123.45"
    }
  ],
  "total_amount_usd": "1234.56"
}

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"