GET
/
beta
/
svm
/
balances
/
{uri}
Get SVM token balances
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=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
default:86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
required

SVM address

Query Parameters

​
chains
string

Comma-separated list of chains to include

​
limit
integer
default:1000

Maximum number of results to return. Default is 1000 when not provided. Values above 1000 are reduced to 1000.

Required range: 1 <= x <= 1000
​
offset
string

Pagination offset from previous response

Response

Successful response

​
wallet_address
string
required

The queried wallet address

​
balances
object[]
required

Array of token balance objects

​
processing_time_ms
number

Time taken to process the request in milliseconds

​
next_offset
string

Pagination token for the next page of results

​
balances_count
number

Total number of balances returned