Analyze net capital flows from smart money traders and funds across tokens and time periods.
What it does
The Nansen Smart Money Netflow endpoint returns aggregated net capital flow data (inflows vs outflows) from smart traders and funds. It covers 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. Results span multiple time periods (1h, 24h, 7d, 30d) and are sortable by volume metrics.
This endpoint is part of the broader Nansen API v1, which provides blockchain analytics across 20+ chains including Ethereum, Solana, Base, BNB, Arbitrum, and more. The netflow endpoint accepts a POST request with chain selection, smart money label filters (Fund, Smart Trader, 30D/90D/180D Smart Trader), pagination, and optional filters for token address, sector, market cap, token age, and trader count. It returns token address, symbol, chain, net flow values across time windows, trader count, token age, market cap, and token sectors.
Pricing is $0.05 per call via the x402 protocol, or 50 credits (free tier) / 5 credits (pro tier) when using Nansen API key authentication. The endpoint supports rate limiting with per-second and per-minute windows. Response headers include credits used, credits remaining, and rate limit status.
Capabilities
Use cases
- —Identify which tokens smart money is accumulating or distributing across multiple chains
- —Monitor net capital flows from funds and smart traders over 1h, 24h, 7d, and 30d windows
- —Screen for tokens with high smart money inflow relative to market cap
- —Track sector-level smart money rotation patterns
- —Build automated trading signals based on smart money net flow changes
Fit
Best for
- —Crypto traders seeking smart money alpha signals
- —Portfolio managers tracking institutional on-chain flows
- —DeFi researchers analyzing token accumulation patterns
- —Trading bots that need programmatic access to smart money data
- —Multi-chain analytics dashboards
Not for
- —Real-time sub-second trading signals (data has some latency)
- —Non-crypto or traditional finance flow analysis
- —Free unlimited usage (each call costs $0.05 or credits)
Quick start
curl -X POST https://api.nansen.ai/api/v1/smart-money/netflow \
-H 'Content-Type: application/json' \
-d '{
"chains": ["ethereum"],
"filters": {
"include_stablecoins": false,
"include_native_tokens": false
},
"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": 5500000000,
"token_age_days": 780,
"net_flow_1h_usd": 50000,
"net_flow_7d_usd": 3500000,
"net_flow_24h_usd": 1250000,
"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 pricing ($0.05/call via x402), comprehensive filter and sort options, and a live 402 MPP challenge confirming the endpoint is operational. Minor deduction because no example response was captured from a live call — the example is constructed from the schema.
Warnings
- —No live response body was captured; example response is inferred from the OpenAPI schema.
- —The probe returned 402 via HEAD which confirms liveness but did not capture the x402 payment challenge details (x402_challenge is null).
Citations
- —The endpoint is POST /api/v1/smart-money/netflow and costs $0.05 per call via x402 protocolhttps://api.nansen.ai
- —Net flows include DEX trading activity and CEX transfers with multiple time period analysis (1h, 24h, 7d, 30d)https://api.nansen.ai
- —Credit costs are 50 (free tier) and 5 (pro tier) per callhttps://api.nansen.ai
- —Supports chains including ethereum, solana, base, bnb, arbitrum, avalanche, and morehttps://api.nansen.ai
- —Smart money label filters include Fund, Smart Trader, 30D/90D/180D Smart Traderhttps://api.nansen.ai