Browse and filter Polymarket prediction markets by volume, liquidity, price, and status via Nansen's API.
What it does
This endpoint is part of Nansen's comprehensive blockchain analytics API and specifically targets the Prediction Markets domain. It lets you screen all Polymarket prediction markets with sorting by volume (24h, 1wk, 1mo, total), liquidity, open interest, unique traders, and market age. You can filter by search query, active/closed status, tags, price range, liquidity bounds, open interest bounds, end-date windows, and neg-risk framework. Results include market metadata (question, slug, event info), pricing (best bid/ask, last trade price, 24h price change), and activity metrics.
The endpoint accepts a POST request with a JSON body conforming to the MarketScreenerRequest schema. Pagination is supported up to 1000 records per page. Sorting uses the order_by array with fields like volume_24hr, liquidity, open_interest, etc. The response returns a paginated list of MarketScreenerItem objects. The endpoint costs 10 credits on the free tier and 1 credit on the pro tier per call, or $0.01 via the x402 pay-per-request protocol.
Nansen's API covers 40+ endpoints across Smart Money tracking, Token God Mode analytics, wallet profiling, perpetual trading data, and prediction markets. This particular endpoint is one of 12 prediction-market endpoints that together provide OHLCV candles, orderbooks, top holders, trades, PnL analysis, and event screening for Polymarket.
Capabilities
Use cases
- —Find the most actively traded Polymarket prediction markets by 24h volume
- —Filter prediction markets by category tags (e.g., Crypto, Politics) and active status
- —Identify new prediction markets with high liquidity and open interest
- —Monitor price changes and trading activity across all Polymarket markets
- —Build dashboards or bots that track trending prediction market events
Fit
Best for
- —Agents that need to discover and rank active Polymarket prediction markets
- —Quantitative researchers analyzing prediction market liquidity and volume
- —Applications building prediction market aggregators or screeners
- —Traders looking for high-volume or newly created prediction markets
Not for
- —Real-time sub-second prediction market price feeds (data is polled periodically)
- —Non-Polymarket prediction platforms (this endpoint only covers Polymarket)
- —Users needing free unlimited access (endpoint consumes credits or requires x402 payment)
Quick start
curl -X POST https://api.nansen.ai/api/v1/prediction-market/market-screener \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_API_KEY' \
-d '{"order_by":[{"field":"volume_24hr","direction":"DESC"}],"status":"active","pagination":{"page":1,"per_page":5}}'Example
Request
{
"tags": [],
"query": "",
"status": "active",
"order_by": [
{
"field": "volume_24hr",
"direction": "DESC"
}
],
"pagination": {
"page": 1,
"per_page": 10
},
"max_liquidity": -1,
"min_liquidity": -1,
"min_volume_24hr": -1,
"max_open_interest": -1,
"min_open_interest": -1
}Response
{
"data": [
{
"slug": "will-bitcoin-reach-100k",
"tags": [
"Crypto",
"Bitcoin"
],
"active": true,
"closed": false,
"volume": 5200000,
"best_ask": 0.64,
"best_bid": 0.62,
"event_id": "12345",
"neg_risk": false,
"question": "Will Bitcoin reach $100k by end of 2025?",
"age_hours": 720.5,
"liquidity": 850000,
"market_id": "654412",
"volume_1wk": 1500000,
"event_title": "Bitcoin Price Milestones",
"volume_24hr": 320000,
"open_interest": 1200000,
"last_trade_price": 0.63,
"unique_traders_24h": 145,
"one_day_price_change": 0.02
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models and clear pricing ($0.01 per call via x402). However, the MPP probe returned 502 (not a clean 402 challenge), so liveness via MPP specifically could not be confirmed. The endpoint is documented as supporting x402 protocol. No crawled docs beyond the API root health check.
Warnings
- —MPP probe returned HTTP 502 on both HEAD and GET — the endpoint may not support MPP natively; it appears to use x402 protocol instead for pay-per-request
- —No external documentation pages were crawlable beyond the API health endpoint
- —Response schema fields are inferred from the OpenAPI spec MarketScreenerItem; actual response structure not directly observed
Citations
- —The market-screener endpoint costs 10 credits (free) or 1 credit (pro) per call, or $0.01 via x402https://api.nansen.ai
- —The endpoint supports sorting by volume_24hr, volume, volume_1wk, volume_1mo, liquidity, open_interest, unique_traders_24h, and age_hourshttps://api.nansen.ai
- —Nansen API v1 provides OpenAPI 3.1.0 specification with prediction market endpoints for Polymarket datahttps://api.nansen.ai