Balances

profiler/address/balances

post

Token balances for a given set of addresses. For each token balance, it provides details like which chain the token is on, the current price in USD, the token balance value in USD and the token's logo URL.

Authorizations

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/profiler/address/balances HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 169

{
  "parameters": {
    "chain": "ethereum",
    "walletAddresses": [
      "0x28c6c06298d514db089934071355e5743bf21d60"
    ],
    "suspiciousFilter": "on"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "chain": "text",
    "tokenAddress": "text",
    "symbol": "text",
    "name": "text",
    "tokenAmount": 1,
    "priceUsd": 1,
    "usdValue": 1
  }
]

profiler/address/historical-balances

post

Historical native coin & token balances of specific group of addresses. For each date within a defined timeframe, it ranks tokens by their approximate USD balance, consolidating those not in the top 10 or below a 2% total daily balance threshold into an 'Other' category. It also offers functionality to exclude tokens labeled as suspicious. The final view provides a daily breakdown of top tokens, aiding in understanding the historical distribution and significance of token balances by their USD value.

Authorizations

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/profiler/address/historical-balances HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "parameters": {
    "walletAddresses": [
      "0x28c6c06298d514db089934071355e5743bf21d60"
    ],
    "chain": "ethereum",
    "suspiciousFilter": "on",
    "timeFrame": 1
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "blockTimestamp": "text",
    "tokenAddress": "text",
    "chain": "text",
    "usdBalance": "text",
    "symbol": "text"
  }
]

Performance Tips

To ensure optimal performance when using the balances API:

• Limit the number of chains included in a single request.

• Use a shorter `look-back` window, such as 1 month, for faster response times.

• Avoid querying very large timeframes.