GET
/
beta
/
balance
/
{address}
curl --request GET \
  --url https://api.dune.com/api/beta/balance/{address} \
  --header 'X-DUNE-API-KEY: <x-dune-api-key>'
{
  "request_time": "2023-11-07T05:31:56Z",
  "response_time": "2023-11-07T05:31:56Z",
  "wallet_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "balances": [
    {
      "chain": "ethereum",
      "address": "native",
      "amount": "605371497350928252303",
      "symbol": "ETH",
      "decimals": 18,
      "price_usd": 3042.816964922323,
      "value_usd": 1842034.6622198338
    },
    {
      "chain": "ethereum",
      "address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
      "amount": "10000000000000000",
      "symbol": "AAVE",
      "decimals": 18,
      "price_usd": 84.98095610644617,
      "value_usd": 0.8498095610644617
    },
    {
      "chain": "optimism",
      "address": "0x4200000000000000000000000000000000000042",
      "amount": "7546290050379685580416",
      "symbol": "OP",
      "decimals": 18,
      "price_usd": 2.3725008543999992,
      "value_usd": 17903.57959207602
    },
    {
      "chain": "polygon",
      "address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
      "amount": "5399227165596652653",
      "symbol": "DAI",
      "decimals": 18,
      "price_usd": 0.9999638397385662,
      "value_usd": 5.399031928130804
    },
    {
      "chain": "arbitrum",
      "address": "0x74885b4d524d497261259b38900f54e6dbad2210",
      "amount": "46901991483382549444",
      "symbol": "APE",
      "decimals": 18
    },
    {
      "chain": "base",
      "address": "0x2f105b53a3ab17100ad47027792012bb02c4c281",
      "amount": "27000000000000000000000000000"
    }
  ]
}

The Token Balances API provides accurate and fast (sub 500ms) real time balances of the native and ERC20 tokens of accounts on supported blockchains (EVM currently).

  • URL may change
  • verify ?all_chains is in the url to access all supported chains
  • Currently no filtering available (e.g. Spam filtering)
  • We are using CoinMarketCap for price information

Filter by blockchain

https://api.dune.com/api/beta/balances/{chain}/{address}?all_chains

Column Descriptions

ColumnDescriptionType
request_timeTime of requesttimestamp
response_timeTime of responsetimestamp
wallet_addressWallet addressstring
chainName of blockchain of tokenstring
addressERC20 contract address or blockchain name for native tokenstring
amountAmount of token owned in WEIdouble
symbolSymbol of token, if avilablestring
decimalsDecimals of token, if availabledouble
price_usdCurrent price of token, if availabledouble
value_usdCurrent value of token owned, if availabledouble

Headers

X-DUNE-API-KEY
string
required

API Key for the service

Path Parameters

address
string
required

The wallet address to retrieve balances for.

Response

200 - application/json
request_time
string

Time when the request was made.

response_time
string

Time when the response was sent.

wallet_address
string

The queried wallet address.

balances
object

results from query