Address Current Balances

Get real-time token balance information for any blockchain address or entity

Common Scenarios

Usecase
Required Parameters
Optional Filters
Expected Output

Check current holdings for a single address

address = "0x28c6c06298d514db089934071355e5743bf21d60", chain = "ethereum"

hide_spam_token = true,

List of tokens with amounts, USD values, and chain info for the address

View entity-wide portfolio (e.g., Vitalik Buterin)

entity_name = "Vitalik Buterin", chain = "all"

hide_spam_token = true

Aggregated balances for entity across all wallets, showing holdings per chain

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

Note: The address field in the response will be empty if entity_name is provided.

Authorizations
Body
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
post
/api/v1/profiler/address/current-balance
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: 136

{
  "address": "0x28c6c06298d514db089934071355e5743bf21d60",
  "chain": "ethereum",
  "hide_spam_token": true,
  "pagination": {
    "page": 1,
    "per_page": 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
    }
  ]
}
PreviousProfilerNextAddress Historical Balances

Last updated

Was this helpful?