Screen tokens across chains with smart money, volume, liquidity, and holder metrics via Nansen's API
What it does
The Nansen Token Screener endpoint (`POST /api/v1/token-screener`) discovers and filters tokens across 25+ blockchains using advanced criteria including volume, liquidity, market cap, price change, smart money activity, holder distribution, and trading patterns. It is one endpoint within the broader Nansen API v1 suite, which also covers smart money netflows, DEX trades, wallet profiling, PnL analysis, Token God Mode analytics, perpetual contract data (Hyperliquid), Polymarket prediction markets, DeFi portfolio holdings, and an AI research agent.
The token screener accepts POST requests with a JSON body specifying chains (up to 5), a timeframe (5m to 30d), pagination, filters (smart money labels, sector, market cap, FDV, volume, netflow, price change, liquidity, trader counts), and sort order. Responses include per-token rows with chain, address, symbol, price, volume, buy/sell breakdown, netflow, market cap, FDV, liquidity, and price change. The endpoint costs $0.01 per call via x402 protocol, or 10 free-tier credits / 1 pro credit via API key. Rate limits are exposed via response headers (per-second and per-minute windows).
The full Nansen API spans ~45 endpoints organized into Smart Money, Profiler, Token God Mode, Token Screener, Perp Screener, Prediction Markets, Portfolio, Search, Perp Leaderboard, and Agent categories. Pricing ranges from $0.01 to $7.50 per call depending on the endpoint. The API uses OpenAPI 3.1.0, returns JSON, and supports both API-key auth and x402 pay-per-request.
Capabilities
Use cases
- —Screen tokens across multiple chains by smart money activity, volume, and liquidity to find trading opportunities
- —Track smart money netflows and holdings to identify accumulation or distribution patterns
- —Profile wallet addresses with PnL, counterparties, balances, labels, and related wallets
- —Analyze Polymarket prediction markets including OHLCV, orderbook, top holders, and PnL
- —Query Hyperliquid perpetual positions, trades, and leaderboards for derivatives intelligence
Fit
Best for
- —Agents and bots that need real-time multi-chain token discovery with smart money signals
- —Portfolio analytics tools requiring wallet profiling, PnL, and DeFi holdings data
- —Research workflows combining on-chain flow intelligence with prediction market analytics
Not for
- —Historical tick-level order book data for centralized exchanges
- —NFT collection analytics or NFT-specific pricing (limited to transfer data only)
- —Free unlimited usage — all data endpoints consume credits or require x402 payment
Quick start
curl -X POST https://api.nansen.ai/api/v1/token-screener \
-H 'Content-Type: application/json' \
-d '{
"chains": ["ethereum"],
"timeframe": "24h",
"pagination": {"page": 1, "per_page": 5},
"order_by": [{"field": "volume", "direction": "DESC"}]
}'Example
Request
{
"chains": [
"ethereum",
"solana"
],
"filters": {
"volume": {
"min": 50000
},
"market_cap_usd": {
"min": 1000000
},
"include_stablecoins": false
},
"order_by": [
{
"field": "netflow",
"direction": "DESC"
}
],
"timeframe": "24h",
"pagination": {
"page": 1,
"per_page": 10
}
}Response
{
"data": [
{
"fdv": 4800000000,
"chain": "ethereum",
"volume": 6000000,
"netflow": 400000,
"liquidity": 25000000,
"price_usd": 0.0000115,
"buy_volume": 3200000,
"sell_volume": 2800000,
"price_change": 5.2,
"token_symbol": "PEPE",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"market_cap_usd": 4500000000,
"token_age_days": 780
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with detailed endpoint descriptions, request/response models, credit costs, and x402 pricing. The 402 MPP challenge was captured confirming the endpoint is live. Minor deduction because no crawled documentation pages were available (all returned routing errors) and component schema $refs are not fully resolved in the probe.
Warnings
- —No external documentation pages were reachable (docs, pricing, README all returned 404-like routing errors); all claims are derived from the OpenAPI spec and probe data only.
- —The MPP challenge body was empty and www_authenticate was null, so exact payment envelope details could not be verified beyond the 402 status.
Citations
- —Token screener endpoint is POST /api/v1/token-screener with x402 payment at $0.01 per callhttps://api.nansen.ai
- —API covers 45+ endpoints across Smart Money, Profiler, Token God Mode, Screener, Prediction Markets, Portfolio, Search, Perp Leaderboard, and Agent categorieshttps://api.nansen.ai
- —Expert agent endpoint costs $7.50 per call; fast agent costs $2.00https://api.nansen.ai
- —Supports 25+ chains including ethereum, solana, base, arbitrum, bnb, polygon, monad, sui, ton, tron, and othershttps://api.nansen.ai