Holdings

Aggregated token holdings data for smart traders and funds.

Common Scenarios

Usecase	Required Parameters	Filters	Sorting Logic	Expected Output
View smart trader token holdings across chains	chains = ["ethereum", "solana"]	N/A	order_by = [{field: "value_usd", direction: "DESC"}]	Aggregated list of tokens held by smart traders on specified chains
Monitor top accumulating tokens this week	chains = "all",	filters = {balance_24h_percent_change: {min: 10}},	order_by = [{field: "balance_24h_percent_change", direction: "DESC"}]	Tokens showing largest recent increases in smart trader holdings
Screen for newly held tokens with threshold value	chains = "all",	filters = {token_age_days: {max: 30}, value_usd: {min: 10000}}	order_by = [{field: "token_age_days", direction: "ASC"}]	Newly acquired tokens by smart money, filtered by age and min USD value

Get Smart Money Holdings Data

post

Retrieve aggregated token balances held by smart traders and funds across multiple blockchains. This endpoint provides insights into what tokens are being accumulated by sophisticated market participants, excluding whales, large holders, and influencers to focus specifically on trading expertise.

Key Features:

• Aggregated balances (not per-wallet breakdowns)

• 24-hour balance change tracking updated in realtime

• Sector categorization for tokens

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

filtersany ofOptional

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

Example: {"balance_24h_percent_change":{"max":0.1,"min":-0.1},"exclude_smart_money_labels":["30D Smart Trader"],"include_native_tokens":false,"include_smart_money_labels":["Fund","Smart Trader"],"include_stablecoins":false,"token_age_days":{"max":30},"value_usd":{"max":100000,"min":1000}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering.

Examples:

• [{"field": "value_usd", "direction": "DESC"}] - Sort by value USD descending
• [{"field": "holders_count", "direction": "ASC"}] - Sort by number of holders ascending
• [{"field": "value_usd", "direction": "DESC"}, {"field": "holders_count", "direction": "ASC"}] - Sort by value USD descending, then number of holders ascending

Responses

200

Smart money holdings 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

/api/v1/smart-money/holdings

HTTPcURLJavaScriptPython

POST /api/v1/smart-money/holdings HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 410

{
  "chains": [
    "ethereum",
    "solana"
  ],
  "filters": {
    "balance_24h_percent_change": {
      "max": 0.1,
      "min": -0.1
    },
    "exclude_smart_money_labels": [
      "30D Smart Trader"
    ],
    "include_native_tokens": false,
    "include_smart_money_labels": [
      "Fund",
      "Smart Trader"
    ],
    "include_stablecoins": false,
    "token_age_days": {
      "max": 30
    },
    "value_usd": {
      "max": 100000,
      "min": 1000
    }
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "order_by": [
    {
      "field": "chain",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "chain": "all",
      "token_address": "text",
      "token_symbol": "text",
      "token_sectors": [
        "text"
      ],
      "value_usd": 1,
      "balance_24h_percent_change": 1,
      "holders_count": 1,
      "share_of_holdings_percent": 1,
      "token_age_days": 1,
      "market_cap_usd": 1
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}