# Nansen Perp Screener > Nansen Perp Screener 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). Screen and filter perpetual contracts on Hyperliquid by volume, open interest, funding rates, and smart money activity over a specified date range. ## Facts - Endpoint: POST https://api.nansen.ai/api/v1/perp-screener?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-perp-screener-2161c134 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hN-FyWhjaFWfnmuiK6DXc 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-perp-screener-2161c134 -d '' ``` Example prompt: Can you screen Hyperliquid perpetual contracts for January 2025 and show me the ones with at least $1M in volume and positive funding rates — I want to see which ones are attracting the most smart money activity? ## When to prefer this Use this endpoint when you need to discover or rank perpetual contracts on Hyperliquid based on quantitative metrics like volume, open interest, funding rates, or smart money positioning. Prefer this over the Perp Trades endpoint (which shows individual trades for a specific token) when you want a broad market overview or want to identify which contracts to investigate further. ## Known failure modes - Missing required 'date' field returns 422 validation error - Invalid date format returns parsing error - Overly restrictive filters return empty data array - Date range too large may result in timeout or truncated results - Invalid filter field types (e.g. string instead of number) return schema validation error ## How this service works Discover and screen perpetual contracts on Hyperliquid with advanced filtering capabilities. This endpoint helps identify trending perpetual contracts, trading activity, funding rates, and smart money movements by combining metrics like volume, open interest, funding rates, and position data. **What it helps to answer:** 1. **Which perpetual contracts are experiencing significant trading volume and activity?** 2. **How do funding rates correlate with trading patterns and smart money positions?** 3. **What perpetual contracts show strong fundamentals in terms of open interest and trading patterns?** 4. **Which perpetual contracts are attracting smart money participation with long/short positions?** ## Output Returns a paginated list of perpetual contract records for the specified date range, each including token symbol, total volume, buy/sell volume breakdown, mark price, funding rate, open interest, trader count, buy/sell pressure, and smart money long/short position metrics. Supports filtering on all key metrics. ## Request schema (JSON Schema) ```json { "type": "object", "title": "PerpScreenerRequest", "required": [ "date" ], "properties": { "date": { "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." }, "filters": { "anyOf": [ { "type": "object", "title": "PerpScreenerFilters", "properties": { "volume": { "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": 1000000 } ], "description": "Total traded notional in USD range filter" }, "funding": { "anyOf": [ { "type": "object", "title": "NumericRangeFilter", "properties": { "max": { "anyOf": [ { "type": "number" } ], "title": "Max", "examples": [ 50000, 10000000, 100 ], "description": "Maximum value (inclusive)" }, "min": { "anyOf": [ { … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "title": "PerpScreenerResponse", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "anyOf": [ { "type": "object", "title": "PerpScreenerDataDefault", "required": [ "token_symbol" ], "properties": { "volume": { "anyOf": [ { "type": "number" } ], "title": "Volume", "examples": [ 427486.75766, 1250000.45, 2500000, 500000, 750000 ], "description": "Total traded notional in USD over the recent window." }, "funding": { "anyOf": [ { "type": "number" } ], "title": "Funding", "examples": [ 0.0000125, 0.0001, -0.0001, 0.0005, -0.0005, 0.001, -0.001, 0.0002, -0.0002, 0.0003 ], "description": "Latest funding rate/value for the coin." }, "buy_volume": { "anyOf": [ { "type": "number" } ], "title": "Buy Volume", "examples": [ 216502.59923, 625000.25, 1250000, 250000, 375000 ], "description": "Total USD value of market buy trades over the recent window." }, "mark_price": { "anyOf": [ { "type": "number" } ], "title": "Mark Price", "examples": [ 0.3301, 45000, 3000, 100, 25, 0.5, 0.01, 15, 8, 150 ], "description": "Latest mark price for the coin." }, "sell_volume": { "anyOf": [ { "type": "number" } ], "title": "Sell Volume", "examples": [ 210984.15843, 625000.2, 1250000, 250000, 375000 ], "description": "Total USD value of market sell trades over the recent window." }, "price_change": { "anyOf": [ { "type": "number" } ], "title": "Price Change", "examples": [ -0.2055, 0.0227, 0.0345 ], "description": "Signed ratio change over the date window, window_end_price_usd / previous_price_usd - 1 (0.05 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-perp-screener-2161c134/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)