GET
https://api.sim.dune.com
/
beta
/
svm
/
balances
/
{uri}
curl --request GET \
  --url https://api.sim.dune.com/beta/svm/balances/{uri} \
  --header 'X-Sim-Api-Key: <x-sim-api-key>'
{
  "processing_time_ms": 120,
  "wallet_address": "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK",
  "next_offset": "eyJibG9ja190aW1lIjoxNjgwMDAwMDAwLCJpbmRleCI6MH0=",
  "balances_count": 2,
  "balances": [
    {
      "chain": "solana",
      "address": "native",
      "amount": "1000000000",
      "balance": "1.0",
      "value_usd": 20.5,
      "program_id": null,
      "decimals": 9,
      "total_supply": "1000000000000000",
      "name": "Solana",
      "symbol": "SOL",
      "uri": null,
      "price_usd": 20.5,
      "liquidity_usd": 500000000,
      "pool_type": null,
      "pool_address": null,
      "mint_authority": null
    }
  ]
}

The Token Balances API provides accurate and fast real time balances of the native, SPL and SPL-2022 tokens of accounts on supported SVM blockchains. We currently support Solana and Eclipse.

  • These endpoints are authenticated with a normal Sim API key.
  • Specify ?chains=all to fetch balances for all supported chains.
  • Specify ?chains=solana,eclipse to fetch balances only for select chains.
  • Token metadata includes symbols, decimals, and price information when available.

​
Response Structure

The API returns a JSON object with the following top-level fields:

FieldDescriptionType
processing_time_msTime taken to process the request in millisecondsnumber
wallet_addressThe queried wallet addressstring
next_offsetPagination token for the next page of resultsstring/null
balances_countTotal number of balances returnednumber
balancesArray of token balance objectsarray

​
Balance Object Fields

Each item in the balances array contains the following fields:

FieldDescriptionType
chainName of blockchain of tokenstring
addressToken contract address or blockchain name for native tokenstring
amountAmount of token owned in smallest unitstring
balanceFormatted amount with decimals appliedstring
value_usdCurrent value of token owned, if availablenumber
program_idProgram ID of the token (for SPL tokens)string
decimalsDecimals of tokennumber
total_supplyTotal supply of the tokenstring
nameName of tokenstring
symbolSymbol of tokenstring
uriURI to token metadatastring
price_usdCurrent price of token, if availablenumber
liquidity_usdLiquidity in USD, if availablenumber/null
pool_typeType of liquidity pool, if availablestring/null
pool_addressAddress of liquidity pool, if availablestring/null
mint_authorityMint authority address, if availablestring/null

​
Pagination

This endpoint is using cursor based pagination. You can use the limit parameter to define the maximum page size. Results might at times be less than the maximum page size. The next_offset value is passed back by the initial response and can be used to fetch the next page of results, by passing it as the offset query parameter in the next request.

You can only use the value from next_offset to set the offset parameter of the next page of results. Using your own offset value will not have any effect.

Headers

​
X-Sim-Api-Key
string
required

API key to access the service

Path Parameters

​
uri
string
required

SVM address

Query Parameters

​
chains
string

Comma-separated list of chains to include, or 'all' for all supported chains

​
limit
integer
default:100

Maximum number of results to return

​
offset
string

Pagination offset from previous response

Response

200
application/json

Successful response

The response is of type object.