Aggregated token holdings data from Nansen's smart money wallets across multiple blockchains, paid per call via x402.
What it does
The Nansen Smart Money Holdings endpoint returns aggregated token balances held by smart traders and funds across multiple blockchains. It focuses specifically on trading expertise by excluding whales, large holders, and influencers. The data includes real-time 24-hour balance change tracking, sector categorization for tokens, holder counts, share-of-holdings percentages, token age, and market cap. Results can be filtered by chain, smart money label type (Fund, Smart Trader, 30D/90D/180D Smart Trader), token address/symbol, sector, stablecoin/native token inclusion, and various numeric range filters on value, holders, and market cap.
This is a POST endpoint at `https://api.nansen.ai/api/v1/smart-money/holdings` that accepts a JSON body specifying chains, filters, pagination, and sort order. It is part of the broader Nansen API v1 suite which includes 40+ endpoints covering smart money netflows, DEX trades, perpetual trades, wallet profiling, Token God Mode analytics, prediction markets (Polymarket), token screening, and AI research agents. The endpoint costs $0.05 per call via the x402 payment protocol (or 50 free-tier credits / 5 pro-tier credits with an API key). The API returns standard pagination, rate limit headers, and credits-used/remaining headers. Supported chains include Ethereum, Solana, Base, BNB, Arbitrum, Avalanche, Optimism, Polygon, Scroll, Sei, Linea, Mantle, Monad, Ronin, HyperEVM, IoTa EVM, Plasma, and Sonic.
Capabilities
Use cases
- —Identify which tokens smart money traders and funds are accumulating across chains
- —Monitor 24-hour balance changes to detect early accumulation or distribution signals
- —Filter holdings by sector (DeFi, Gaming, AI, etc.) to track smart money rotation
- —Build automated trading signals based on smart money portfolio composition
- —Research token fundamentals by examining which sophisticated traders hold them
Fit
Best for
- —Crypto traders seeking alpha from smart money on-chain signals
- —Portfolio managers tracking institutional and fund token allocations
- —DeFi researchers analyzing cross-chain smart money behavior
- —Automated trading bots that consume on-chain intelligence APIs
- —Analysts building dashboards of smart money token positions
Not for
- —Real-time sub-second trading data (data is aggregated, not tick-level)
- —NFT analytics or non-fungible token tracking
- —Historical time-series of holdings (use the separate historical-holdings endpoint instead)
Quick start
curl -X POST https://api.nansen.ai/api/v1/smart-money/holdings \
-H 'Content-Type: application/json' \
-H 'Payment-Signature: <x402_payment_signature>' \
-d '{
"chains": ["ethereum"],
"filters": {"include_stablecoins": false, "include_native_tokens": false},
"pagination": {"page": 1, "per_page": 10}
}'Example
Request
{
"chains": [
"ethereum",
"solana"
],
"filters": {
"value_usd": {
"max": 100000,
"min": 1000
},
"token_age_days": {
"max": 30
},
"include_stablecoins": false,
"include_native_tokens": false,
"include_smart_money_labels": [
"Fund",
"Smart Trader"
]
},
"order_by": [
{
"field": "value_usd",
"direction": "DESC"
}
],
"pagination": {
"page": 1,
"per_page": 10
}
}Response
{
"data": [
{
"chain": "ethereum",
"value_usd": 95000.5,
"token_symbol": "PEPE",
"holders_count": 42,
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"token_sectors": [
"Memecoin"
],
"market_cap_usd": 5000000000,
"token_age_days": 25,
"share_of_holdings_percent": 0.03,
"balance_24h_percent_change": 0.12
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear x402 payment info ($0.05/call), live 402 challenge confirmed, comprehensive filter and sort documentation. Minor gap: no crawled docs page (returns 404), but the OpenAPI spec itself is thorough.
Warnings
- —No dedicated documentation page was reachable at api.nansen.ai/docs — all docs are inferred from the OpenAPI spec
- —Response schema references SmartMoneyHoldingsResponse but full field-level response examples are constructed from schema definitions, not live responses
Citations
- —Endpoint costs $0.05 per call via x402 protocolhttps://api.nansen.ai
- —Endpoint is a POST at /api/v1/smart-money/holdings with SmartMoneyHoldingsRequest schemahttps://api.nansen.ai
- —Excludes whales, large holders, and influencers to focus on trading expertisehttps://api.nansen.ai
- —Supports chains including ethereum, solana, base, bnb, arbitrum, and others listed in SmartMoneyChain enumhttps://api.nansen.ai
- —x402 challenge returned HTTP 402 confirming endpoint is livehttps://api.nansen.ai/api/v1/smart-money/holdings