Address Current Balances

Get Address Current Balance Data

post

Retrieve current token holdings for addresses or entities. Returns detailed balance information across specified chains.

What it helps to answer:

• Current token holdings with quantities and USD valuations

• Asset distribution across different blockchain networks

• Native token versus token balances

• Stablecoin holdings and percentages

• Cross-chain portfolio composition

Authorizations

ApiKeyAuth

Body

application/json

addressany ofOptional

Address to get balances for

Example: 0x28c6c06298d514db089934071355e5743bf21d60

stringOptional

entity_nameany ofOptional

Entity name to get balances for

Example: Vitalik Buterin

stringOptional

chainstring · enumRequired

Blockchain chain for the balances

Example: ethereumPossible values:

hide_spam_tokenbooleanOptional

Removes suspicious tokens from the balance list

Default: trueExample: true

filtersany ofOptional

Additional filters to apply. Only filters for columns that are being selected will be applied.

Example: {"token_symbol":"USDC","value_usd":{"min":10}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering

Responses

200

Address current balance data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/profiler/address/current-balance HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 137

{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "hide_spam_token": true,
  "pagination": {
    "page": 1,
    "page_size": 10
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "chain": "text",
      "address": "text",
      "token_address": "text",
      "token_symbol": "text",
      "token_name": "text",
      "token_amount": 1,
      "price_usd": 1,
      "value_usd": 1
    }
  ]
}