Skip to main content
GET
/
v1
/
chains
/
{chainId}
/
balances
Get Token Balances for a User or Token
curl --request GET \
  --url https://api.gm.ondo.finance/v1/chains/{chainId}/balances \
  --header 'x-api-key: <api-key>'
{
  "tokens": [
    {
      "tokenAddress": "0x14c3abf95cb9c93a8b82c1cdcb76d72cb87b2d4c",
      "tokenSymbol": "AAPLon",
      "balances": [
        {
          "holderAddress": {
            "account": "0x13116e8b4ffc8125b859ec60917fba540e59e55e"
          },
          "balance": "0.467583800117038432"
        },
        {
          "holderAddress": {
            "account": "0x1db995cb2b3d9679383f0e597704a41e1521f4e1"
          },
          "balance": "0.641380199330235549"
        }
      ]
    },
    {
      "tokenAddress": "0xf6b1117ec07684d3958cad8beb1b302bfd21103f",
      "tokenSymbol": "TSLAon",
      "balances": [
        {
          "holderAddress": {
            "account": "0x00000688768803bbd44095770895ad27ad6b0d95"
          },
          "balance": "0.030594824589372964"
        },
        {
          "holderAddress": {
            "account": "0x1db995cb2b3d9679383f0e597704a41e1521f4e1"
          },
          "balance": "0.088854297224463519"
        }
      ]
    },
    "..."
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.ondo.finance/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
chainId
enum<string>
required

The chain's identifier including the chain name and chain id.

Available options:
ethereum-1,
bsc-56,
solana-900

Query Parameters

​
tokenAddress
string

Filter by a token contract address (optional).

​
userAddress
string

Filter by a user wallet address (optional).

Response

OK

​
tokens
object[]
required