🔢Point-in-time balances

Summary

This endpoint returns the balances of all the tokens at the specified block for the given address. Includes fiat values (in USD) for the popular tokens.

Token standards covered: Native, ERC-20, ERC-721. [ERC-1155 support coming soon]

Syntax

GET /$CHAIN/v1/address/$ADDRESS/balances

Query params

ParamDefault valueNote

block

latest

  • the block at which the balance is requested

Example

Request
curl 'https://api.nexandria.com/eth/v1/address/0xe138f86dd6b379faf87d64fa2c53590d1774719a/balances?block=15000000' -H "API-Key:$API_KEY"
Response
{
   "tokens" : [
      {
         "fiat_value" : "1,175.6281",
         "is_native" : true,
         "name" : "Ethereum",
         "native_balance" : "1.0484",
         "symbol" : "ETH"
      },
      {
         "address" : "0x01454cdc3fab2a026cc7d1cb2aea9b909d5ba0ee",
         "name" : "deApy.org",
         "native_balance" : "300,000.0000",
         "symbol" : "deApy.org"
      },
      {
         "address" : "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
         "sub_tokens" : [
            {
               "raw_id" : "#0xa94c01d1f74c4af25030285b95b4aa8f5d72f3d237248e4c1451c7698413be8f"
            }
         ]
      },
      {
         "address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
         "fiat_value" : "578.5431",
         "name" : "USD Coin",
         "native_balance" : "578.5089",
         "symbol" : "USDC"
      },
      {
         "address" : "0xc36442b4a4522e871399cd717abdd847ab11fe88",
         "name" : "Uniswap V3 Positions NFT-V1",
         "sub_tokens" : [
            {
               "raw_id" : "#70491"
            },
            {
               "raw_id" : "#70510"
            },
            {
               "raw_id" : "#70557"
            },
            {
               "raw_id" : "#70679"
            },
            {
               "raw_id" : "#70734"
            },
            {
               "raw_id" : "#70908"
            },
            {
               "raw_id" : "#70913"
            },
            {
               "raw_id" : "#70921"
            },
            {
               "raw_id" : "#70932"
            },
            {
               "raw_id" : "#70940"
            },
            {
               "raw_id" : "#70989"
            },
            {
               "raw_id" : "#71742"
            },
            {
               "raw_id" : "#73192"
            },
            {
               "raw_id" : "#73729"
            },
            {
               "raw_id" : "#73750"
            },
            {
               "raw_id" : "#74305"
            },
            {
               "raw_id" : "#74550"
            },
            {
               "raw_id" : "#186157"
            }
         ],
         "symbol" : "UNI-V3-POS"
      },
      {
         "address" : "0xf9d25eb4c75ed744596392cf89074afaa43614a8",
         "name" : "Up1.org",
         "native_balance" : "113,054.0000",
         "symbol" : "Up1.org"
      }
   ]
}

Last updated