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
Body
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
post
/api/v1/smart-money/holdings
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
  }
}
PreviousNetflowsNextHistorical Positions

Last updated

Was this helpful?