Balances

profiler/address/balances

post

Current token balance of a given address. For each token, 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.

Parameters

Parameter	Type	Description
wallet_addresses	String	Comma separated list of addresses.
chain	String	'all' for all chain, otherwise chain name.

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
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "parameters": {
    "chain": "ethereum",
    "walletAddresses": [
      "0x28c6c06298d514db089934071355e5743bf21d60"
    ],
    "suspiciousFilter": null
  }
}

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

profiler/address/historical-balances

post

Historical token balance of an address ranked by their approximate USD balance.

Parameters

Parameter	Type	Description
wallet_addresses	String	Wallet addresses input.

                     | | param_chain | String | EVM chain to query, or 'all' for combined view. | | suspicious_filter | String | 'on' of 'off' to filter supicious tokens        | | time_frame | UInt   | Days to query                                   |

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
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "parameters": {
    "walletAddresses": [
      "0x28c6c06298d514db089934071355e5743bf21d60"
    ],
    "chain": "ethereum",
    "suspiciousFilter": null,
    "timeFrame": null
  }
}

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

profiler/address/nft-balances

post

NFT Holdings

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/nft-balances HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "parameters": {
    "address": null
  }
}

[
  {
    "projectId": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
    "nftBalance": 18,
    "estimatedValue": 86.32,
    "medianPrice": 4.44,
    "nofSales1d": 13,
    "liquidityVelocity": -1.81,
    "liquidity": "High",
    "name": "Pudgy Penguins",
    "hasName": 1
  }
]