# Nansen Token Screener > Nansen Token Screener is a paid API for AI agents from Nansen at api.nansen.ai, paid per call via MPP or x402, $0.01/call, status unknown (last checked 2026-10-12). Screen and discover tokens across up to 5 blockchains using advanced filters for smart money activity, volume, liquidity, market cap, and holder behavior. ## Facts - Endpoint: POST https://api.nansen.ai/api/v1/token-screener?utm_source=zero.xyz - Price: $0.01/call - Payment: MPP, x402 - Status: unknown - Last checked: 2026-10-12 - 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-token-screener-63556c7f - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-l6f8NJHRQKSv8g4IM3TX 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-token-screener-63556c7f -d '' ``` Example prompt: Use Nansen's token screener to find tokens on Ethereum and Solana from the last 7 days that have at least $1M in liquidity, significant smart money inflows, and are less than 90 days old — sort by smart money netflow descending. ## When to prefer this Use this endpoint when you need to discover and rank tokens across multiple blockchains using a combination of smart money signals, on-chain liquidity, volume, and holder metrics. It is ideal for identifying trending or emerging tokens with institutional/smart-money backing. Prefer this over single-chain explorers or basic DEX screeners when multi-chain coverage and smart money intelligence are required simultaneously. ## Known failure modes - Missing required 'chains' field returns validation error - Providing both 'date' and 'timeframe' simultaneously returns an error (mutually exclusive) - Requesting more than 5 chains returns a validation error - Using deprecated 'date' field with a range exceeding 2 months may return incomplete data - Invalid chain enum value returns a 422 unprocessable entity error - Empty result set returned if filters are too restrictive (no tokens match) - Rate limiting or quota exceeded returns 429 or payment-related error ## How this service works Discover and screen tokens across multiple blockchains with advanced filtering capabilities. This endpoint helps identify trending tokens, new launches, and smart money movements by combining metrics like volume, liquidity, market cap, and trading activity. **What it helps to answer:** 1. **Which tokens are experiencing significant smart money activity across different chains?** 2. **How do market metrics (price, volume, liquidity) correlate with holder behavior and smart money movements?** 3. **What tokens show strong fundamentals in terms of holder distribution and trading patterns?** 4. **Which emerging tokens are attracting fresh wallet inflows while maintaining healthy smart money participation?** ## Output Returns a paginated list of tokens matching the filter criteria, each with on-chain metrics including price, market cap, FDV, volume (buy/sell), netflow, liquidity, token age, smart money inflow/outflow ratios, holder counts, and price change percentage — scoped to the requested chains and timeframe. ## Request schema (JSON Schema) ```json { "type": "object", "title": "TokenScreenerRequest", "required": [ "chains" ], "properties": { "date": { "anyOf": [ { "type": "object", "title": "DateRange", "properties": { "to": { "anyOf": [ { "type": "string" } ], "title": "To", "examples": [ "2025-01-31T23:59:59Z" ], "description": "End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)" }, "from": { "anyOf": [ { "type": "string" } ], "title": "From", "examples": [ "2025-01-01T00:00:00Z" ], "description": "Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)" } }, "description": "Date range model matching the API schema." } ], "examples": [ { "to": "2025-01-31T23:59:59Z", "from": "2025-01-01T00:00:00Z" } ], "deprecated": true, "description": "**DEPRECATED**: Use 'timeframe' instead. It offers better reliability and performance.\n\nRequired only if 'timeframe' is not provided.\n\nCustom date range for the token screener. The granularity is automatically determined from the date range:\n- ≤ 1 hour: minute-level data (limited to last 2 hours)\n- > 1 hour to 1 day: hourly data (limited to last 2 days)\n- > 1 day: daily data (limited to last 2 months)\n\nCannot be used together with 'timeframe'." }, "chains": { "type": "array", "items": { "enum": [ "arbitrum", "arc", "avalanche", "base", "bitcoin", "bnb", "citrea", "ethereum", "hyperevm", "injective", "iotaevm", "linea", "mantle", "mantra", "monad", "near", "optimism", "plasma", "polygon", "robinhood", "sei", "solana", "sonic", "starknet", "sui", "ton", "tron" ], "type": "string", "title": "TokenScreenerChain", "description": "Chains supported for Token Screener endpoint." }, "title": "Chains", "examples": [ [ "ethereum", "solana", "base" ] ], "maxItems": 5, "minItems": 1, "description": "List of blockchain chains to filter by" }, "filters": { "anyOf": [ { "type": "object", "title": "TokenScreenerFilters", "properties": { "fdv": { "anyOf": [ { "type": "object", "title": "NumericRangeFilter", "prop … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "title": "TokenScreenerResponse", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "anyOf": [ { "type": "object", "title": "TokenScreenerDataDefault", "required": [ "chain", "token_address", "token_symbol" ], "properties": { "fdv": { "anyOf": [ { "type": "number" } ], "title": "Fdv", "description": "Fully Diluted Valuation in USD." }, "chain": { "type": "string", "title": "Chain", "description": "The blockchain network on which the token is deployed." }, "volume": { "anyOf": [ { "type": "number" } ], "title": "Volume", "description": "Total trading volume in USD." }, "netflow": { "anyOf": [ { "type": "number" } ], "title": "Netflow", "description": "Net flow (buy_volume - sell_volume) in USD." }, "liquidity": { "anyOf": [ { "type": "number" } ], "title": "Liquidity", "description": "Total on-chain liquidity in USD." }, "price_usd": { "anyOf": [ { "type": "number" } ], "title": "Price Usd", "description": "Price of the token" }, "buy_volume": { "anyOf": [ { "type": "number" } ], "title": "Buy Volume", "description": "Total buy volume in USD." }, "sell_volume": { "anyOf": [ { "type": "number" } ], "title": "Sell Volume", "description": "Total sell volume in USD." }, "fdv_mc_ratio": { "anyOf": [ { "type": "number" } ], "title": "Fdv Mc Ratio", "description": "Ratio of Fully Diluted Valuation to Market Cap." }, "price_change": { "anyOf": [ { "type": "number" } ], "title": "Price Change", "description": "Price change percentage from the previous period." }, "token_symbol": { "type": "string", "title": "Token Symbol", "description": "The symbol of the token." }, "token_address": { " … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-token-screener-63556c7f/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)