# Nansen Flow Intelligence > Nansen Flow Intelligence is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP, $0.01/call, status unknown (last checked 2026-10-10). Returns token flow analytics (inflows, outflows, net flows) broken down by holder segments—Whales, Smart Traders, Exchanges, Top PnL, and Public Figures—with trend and accumulation/distribution signals. ## Facts - Endpoint: POST https://api.nansen.ai/api/v1/tgm/flow-intelligence?utm_source=zero.xyz - Price: $0.01/call - Payment: MPP - Status: unknown - Last checked: 2026-10-10 - Activations on Zero: 0 - Provider: Nansen - Docs: https://docs.nansen.ai - Website: https://nansen.ai - Tags: blockchain, smart-money, wallet, tokens, defi, analytics, profiler, dex, pnl, onchain, prediction-market, data - Canonical page: https://www.zero.xyz/c/nansen-flow-intelligence-5dbc00f4 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k8dJXDkMIw_k92u7N_efT Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability nansen-flow-intelligence-5dbc00f4 -d '' ``` Example prompt: Show me the flow intelligence for the PEPE token on Ethereum — I want to see whether whales and smart traders are net buying or selling, and what the exchange flows look like. ## When to prefer this Use this endpoint when you need segmented on-chain flow data for a specific token, particularly to distinguish behavior by holder type (whales vs smart money vs exchanges). It is the best choice over generic holder or transaction endpoints when you want accumulation/distribution intelligence across named wallet categories with USD-denominated flow metrics. ## Known failure modes - Missing required fields (chain or token_address) returns 422 validation error - Unsupported chain value returns enum validation error - Token address not found on specified chain returns empty data array - Invalid numeric range filter (min > max) returns validation error - Rate limit exceeded returns 429 error - Authentication failure returns 401 unauthorized ## How this service works This endpoint provides comprehensive flow intelligence analytics, including inflows, outflows, and net flows for a specific token, broken down by various holder segments (Exchanges, Smart Money, Public Figures, Whales) with time-based statistics and trends. It can be used for identifying accumulation/distribution patterns across different holder segments. ## Output An array of flow intelligence records per token, each containing net flow USD, average flow USD, and wallet counts for up to six holder segments: Whales, Smart Traders, Exchanges, Top PnL wallets, Public Figures, and New Wallets. Includes time-windowed statistics useful for detecting accumulation or distribution trends. ## Request schema (JSON Schema) ```json { "type": "object", "title": "TGMFlowIntelligenceRequest", "required": [ "chain", "token_address" ], "properties": { "chain": { "enum": [ "arbitrum", "arc", "avalanche", "base", "bnb", "ethereum", "hyperevm", "injective", "linea", "mantle", "mantra", "monad", "near", "optimism", "plasma", "polygon", "robinhood", "sei", "solana", "sonic", "starknet", "sui", "ton", "tron" ], "type": "string", "title": "TGMFlowIntelligenceChain", "description": "Chains supported for the TGM flow intelligence endpoint." }, "filters": { "anyOf": [ { "type": "object", "title": "TGMFlowIntelligenceFilters", "properties": { "whale_avg_flow_usd": { "anyOf": [ { "type": "object", "title": "NumericRangeFilter", "properties": { "max": { "anyOf": [ { "type": "number" } ], "title": "Max", "examples": [ 50000, 10000000, 100 ], "description": "Maximum value (inclusive)" }, "min": { "anyOf": [ { "type": "number" } ], "title": "Min", "examples": [ 1000, 1000000, -50, 0 ], "description": "Minimum value (inclusive)" } }, "description": "Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75" } ], "examples": [ { "min": 100 } ], "description": "Whale average flow range filter in USD" }, "whale_net_flow_usd": { "anyOf": [ { "type": "object", "title": "NumericRangeFilter", "properties": { "max": { "anyOf": [ { "type": "number" } ], "title": "Max", "examples": [ 50000, 10000000, 100 ], "description": "Maximum value (inclusive)" }, "min": { "anyOf": [ { "type": "number" } ], "title": "Min", "examples": [ … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "title": "TGMFlowIntelligenceResponse", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "title": "TGMFlowIntelligence", "properties": { "whale_avg_flow_usd": { "anyOf": [ { "type": "number" } ], "title": "Whale Avg Flow Usd", "examples": [ 250000.75 ], "description": "Geometric mean of absolute flow for Whale addresses" }, "whale_net_flow_usd": { "anyOf": [ { "type": "number" } ], "title": "Whale Net Flow Usd", "examples": [ 5000000.25 ], "description": "Net flow (USD) for addresses labeled as Whale" }, "whale_wallet_count": { "anyOf": [ { "type": "integer" } ], "title": "Whale Wallet Count", "examples": [ 25 ], "description": "Unique wallet count for Whale addresses" }, "top_pnl_avg_flow_usd": { "anyOf": [ { "type": "number" } ], "title": "Top Pnl Avg Flow Usd", "examples": [ 100000.5 ], "description": "Geometric mean of absolute flow for Top PnL addresses" }, "top_pnl_net_flow_usd": { "anyOf": [ { "type": "number" } ], "title": "Top Pnl Net Flow Usd", "examples": [ 2000000.75 ], "description": "Net flow (USD) for addresses labeled as Top PnL" }, "top_pnl_wallet_count": { "anyOf": [ { "type": "integer" } ], "title": "Top Pnl Wallet Count", "examples": [ 15 ], "description": "Unique wallet count for Top PnL addresses" }, "exchange_avg_flow_usd": { "anyOf": [ { "type": "number" } ], "title": "Exchange Avg Flow Usd", "examples": [ 150000.5 ], "description": "Geometric mean of absolute flow for Exchange addresses" }, "exchange_net_flow_usd": { "anyOf": [ { "type": "number" } ], "title": "Exchange Net Flow Usd", "examples": [ 3000000.75 ], "description": "Net flow (USD) for addresses labeled as Exchange" }, "exchange_wallet_count": { "anyOf": [ { "type": "integer" } ], "title": "Exchange Wallet Count", "examples": [ 0 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-flow-intelligence-5dbc00f4/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)