Smart money net capital flow analysis across tokens via Nansen's on-chain intelligence, at $0.05 per call.
What it does
The Nansen Smart Money Netflow endpoint analyzes net capital flows (inflows vs outflows) from smart traders and funds across multiple blockchains and time periods. It calculates the difference between smart money inflows and outflows for each token, covering both DEX trading activity (tokens bought vs sold on decentralized exchanges) and CEX transfers (tokens sent to or received from centralized exchanges). Positive net flow indicates smart money accumulation; negative net flow indicates distribution.
The endpoint supports multiple chains including Ethereum, Solana, Base, BNB, Arbitrum, and others. Results can be filtered by smart money label type (Fund, Smart Trader, 30D/90D/180D Smart Trader), token sector, token age, market cap, and trader count. Net flow data is available across four time windows: 1 hour, 24 hours, 7 days, and 30 days. Results are sortable by any net flow period, market cap, trader count, and other fields. The endpoint uses the x402 payment protocol at $0.05 per request (or 50 free-tier credits / 5 pro-tier credits with an API key). It accepts POST requests with a JSON body specifying chains, filters, pagination, and sort order.
Capabilities
Use cases
- —Identify tokens being accumulated or distributed by smart money in real time
- —Screen for tokens with strong smart money net inflows across multiple time horizons
- —Monitor fund and smart trader activity across Ethereum, Solana, and other chains
- —Build trading signals based on smart money accumulation patterns
- —Filter smart money flows by token sector, market cap, or trader count
Fit
Best for
- —Crypto traders seeking alpha from smart money flow signals
- —Portfolio managers monitoring institutional on-chain activity
- —Quantitative researchers building on-chain factor models
- —DeFi analysts tracking capital rotation across tokens and chains
Not for
- —Historical backtesting beyond the provided time windows (use historical-holdings endpoint instead)
- —Individual wallet-level trade details (use smart-money/dex-trades endpoint instead)
- —Non-crypto or traditional finance data
Quick start
curl -X POST https://api.nansen.ai/api/v1/smart-money/netflow \
-H 'Content-Type: application/json' \
-H 'X-Payment: <x402-payment-header>' \
-d '{
"chains": ["ethereum"],
"pagination": {"page": 1, "per_page": 10},
"order_by": [{"field": "net_flow_24h_usd", "direction": "DESC"}]
}'Example
Request
{
"chains": [
"ethereum",
"solana"
],
"filters": {
"market_cap_usd": {
"min": 1000000
},
"include_stablecoins": false,
"include_native_tokens": false,
"include_smart_money_labels": [
"Fund",
"Smart Trader"
]
},
"order_by": [
{
"field": "net_flow_24h_usd",
"direction": "DESC"
}
],
"pagination": {
"page": 1,
"per_page": 10
}
}Response
{
"data": [
{
"chain": "ethereum",
"token_symbol": "PEPE",
"trader_count": 42,
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"token_sectors": [
"Memecoin"
],
"market_cap_usd": 5000000000,
"token_age_days": 780,
"net_flow_1h_usd": 50000,
"net_flow_7d_usd": 3500000,
"net_flow_24h_usd": 1200000,
"net_flow_30d_usd": 8000000
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear endpoint description, x402 402 challenge confirmed live, explicit pricing ($0.05/call), comprehensive filter and sort field enums. Minor gap: no example response in the OpenAPI spec itself, but schema is fully defined.
Warnings
- —No crawled documentation pages were accessible beyond the API root health check; all /docs, /api, /pricing paths returned 404.
- —Example response is inferred from the OpenAPI schema rather than captured from a live call.
Citations
- —Endpoint is live and returns HTTP 402 with x402 payment challengehttps://api.nansen.ai/api/v1/smart-money/netflow
- —Price is $0.05 per request (fixed pricing via x402)https://api.nansen.ai/api/v1/smart-money/netflow
- —Credit cost is 50 (free tier) / 5 (pro tier)https://api.nansen.ai/api/v1/smart-money/netflow
- —Supports chains: all, arbitrum, avalanche, base, bnb, ethereum, hyperevm, iotaevm, linea, mantle, monad, optimism, plasma, polygon, ronin, scroll, sei, solana, sonichttps://api.nansen.ai/api/v1/smart-money/netflow
- —Net flows include DEX trading activity and CEX transfers with 1h, 24h, 7d, 30d time periodshttps://api.nansen.ai/api/v1/smart-money/netflow