Get balances

Get balances of supported assets for an address on the specified network. Only non-zero balances are returned. This feature is in beta - please contact support for access.

organizationId · string · required

Unique identifier for a given organization.

address · string · required

Address corresponding to a wallet account. Private key addresses are not supported.

caip2 · enum<string> · required

Enum options: eip155:1, eip155:11155111, eip155:8453, eip155:84532, eip155:137, eip155:80002, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1

A successful response returns the following fields:

balances · array

List of asset balances

Show balances details

cURL

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_wallet_address_balances \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "address": "<string>",
    "caip2": "<eip155:1>"
}'

import { Turnkey } from "@turnkey/sdk-server";

const turnkeyClient = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
});

const response = await turnkeyClient.apiClient().getWalletAddressBalances({
  organizationId: "<string> (Unique identifier for a given organization.)",
  address: "<string> (Address corresponding to a wallet account. Private key addresses are not supported.)",
  caip2: "<eip155:1>" // CAIP-2 chain ID (e.g., 'eip155:1' for Ethereum mainnet or 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp' for Solana mainnet). Human-readable Solana aliases ('solana:mainnet', 'solana:devnet') are also accepted and normalized to canonical CAIP-2 values.
});

200

{
  "balances": [
    {
      "caip19": "<string>",
      "symbol": "<string>",
      "balance": "<string>",
      "decimals": "<number>",
      "display": {
        "usd": "<string>",
        "crypto": "<string>"
      },
      "name": "<string>"
    }
  ]
}