Holdings

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

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

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
  }
}