Token flow intelligence across smart money, exchanges, whales, and public figures via Nansen
What it does
The Nansen TGM Flow Intelligence endpoint provides comprehensive flow analytics for a specific token, broken down by holder segments: Exchanges, Smart Money, Public Figures, Whales, and Fresh Wallets. It returns net flows, average flows, and wallet counts for each segment across configurable timeframes (5m, 1h, 6h, 12h, 1d, 7d). This helps identify accumulation and distribution patterns by different participant types.
This endpoint is part of the broader Nansen API v1, which covers smart money tracking, wallet profiling, DEX trades, PnL analysis, token screening, perpetual contract analytics (Hyperliquid), prediction market data (Polymarket), and an AI research agent. The flow-intelligence endpoint specifically costs 1 credit (pro plan) or 10 credits (free plan) per call, with x402 pay-per-request pricing at $0.01 per call. It accepts POST requests with chain, token_address, timeframe, and optional filters. Supported chains include Ethereum, Solana, Base, Arbitrum, Polygon, and 20+ others. Rate limits are exposed via response headers (per-second and per-minute windows).
The API uses OpenAPI 3.1 with full schema definitions for request/response models. Authentication is via an `apiKey` header, or alternatively via the x402 payment protocol for pay-per-request access. Fresh wallet data is only available for 1d and 7d timeframes.
Capabilities
Use cases
- —Detect smart money accumulation or distribution for a specific token across multiple timeframes
- —Monitor exchange inflows/outflows to anticipate selling pressure or withdrawal trends
- —Track whale and public figure net flows to gauge large-holder sentiment
- —Identify fresh wallet activity surges that may signal new interest in a token
- —Build automated trading signals based on holder-segment flow divergences
Fit
Best for
- —Crypto traders monitoring smart money and whale behavior for specific tokens
- —DeFi researchers analyzing token flow patterns across holder segments
- —Trading bots that need programmatic access to on-chain flow intelligence
- —Portfolio managers tracking exchange deposit/withdrawal trends
Not for
- —Historical price charting or OHLCV data (use the token-ohlcv endpoint instead)
- —Non-crypto or traditional finance flow analysis
- —Free-tier users needing high-volume access (10 credits per call on free plan)
Quick start
curl -X POST https://api.nansen.ai/api/v1/tgm/flow-intelligence \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-d '{
"chain": "ethereum",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"timeframe": "1d"
}'Example
Request
{
"chain": "ethereum",
"filters": {
"whale_wallet_count": {
"min": 1
}
},
"timeframe": "1d",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
}Response
{
"data": [
{
"whale_avg_flow_usd": 250000.75,
"whale_net_flow_usd": 5000000.25,
"whale_wallet_count": 25,
"exchange_avg_flow_usd": 150000.5,
"exchange_net_flow_usd": 3000000.75,
"exchange_wallet_count": 5,
"smart_trader_avg_flow_usd": 75000.25,
"smart_trader_net_flow_usd": 1500000.5,
"smart_trader_wallet_count": 20,
"fresh_wallets_avg_flow_usd": 25000.75,
"fresh_wallets_net_flow_usd": 500000.25,
"fresh_wallets_wallet_count": 100,
"public_figure_avg_flow_usd": 50000.25,
"public_figure_net_flow_usd": 1000000.5,
"public_figure_wallet_count": 10
}
]
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.01/call via x402), credit costs documented, and the endpoint returned 402 confirming it is live. Docs pages at /docs returned 404 but the OpenAPI spec itself is comprehensive. No actual response example was captured from a live call, so the example response is constructed from the schema.
Warnings
- —No dedicated documentation site was reachable at /docs or /api — all enrichment is from the OpenAPI spec
- —Example response is schema-derived, not from an actual API call
- —Fresh wallet fields are null for timeframes other than 1d and 7d
Citations
- —The flow-intelligence endpoint costs 10 credits (free) or 1 credit (pro) per call, with x402 price of $0.01https://api.nansen.ai
- —Supported timeframes are 5m, 1h, 6h, 12h, 1d, 7dhttps://api.nansen.ai
- —The endpoint is a POST to /api/v1/tgm/flow-intelligence and returns segment-level net flows, avg flows, and wallet countshttps://api.nansen.ai
- —Fresh wallet data is only available for 1d and 7d timeframeshttps://api.nansen.ai
- —The API uses apiKey header authentication and supports x402 pay-per-requesthttps://api.nansen.ai