{"uid":"cap_IAckiUUC7VYcPlceE4OVb","slug":"nansen-market-screener-047f8daa","name":"Nansen Polymarket Market Screener","description":"Browse and filter all Polymarket prediction markets. Supports sorting by volume,\nliquidity, price change, and more. Filter by search query and active/closed status.\n\n**What it helps to answer:**\n\n1. **What are the most active prediction markets right now?**\n2. **Which markets have the highest volume or liquidity?**\n3. **What new markets have been created recently?**","url":"https://api.nansen.ai/api/v1/prediction-market/market-screener?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"MarketScreenerRequest","properties":{"tags":{"type":"array","items":{"type":"string"},"title":"Tags","examples":[["Crypto","Bitcoin"]],"maxItems":50,"description":"Filter by tags"},"query":{"type":"string","title":"Query","default":"","examples":["bitcoin","election"],"maxLength":200,"description":"Search query to filter results"},"status":{"enum":["active","closed",""],"type":"string","title":"MarketStatus","description":"Valid status filters for screener endpoints."},"sort_by":{"enum":["volume_24hr","volume","volume_1wk","volume_1mo","liquidity","open_interest","unique_traders_24h","age_hours"],"type":"string","title":"ScreenerSortField","description":"Valid sort fields for screener endpoints."},"neg_risk":{"anyOf":[{"type":"boolean"}],"title":"Neg Risk","description":"Filter by neg-risk framework (null = no filter)"},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"ScreenerSortOrder","required":["field","direction"],"properties":{"field":{"enum":["volume_24hr","volume","volume_1wk","volume_1mo","liquidity","open_interest","unique_traders_24h","age_hours"],"type":"string","title":"ScreenerSortField","description":"Valid sort fields for screener endpoints."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","examples":[[{"field":"volume_24hr","direction":"DESC"}]],"description":"Sort order"},"max_price":{"type":"number","title":"Max Price","default":-1,"minimum":-1,"description":"Maximum price filter (-1 = no limit)"},"min_price":{"type":"number","title":"Min Price","default":-1,"minimum":-1,"description":"Minimum price filter (-1 = no filter)"},"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."},"max_liquidity":{"type":"number","title":"Max Liquidity","default":-1,"minimum":-1,"description":"Maximum liquidity filter (-1 = no limit)"},"min_liquidity":{"type":"number","title":"Min Liquidity","default":-1,"minimum":-1,"description":"Minimum liquidity filter (-1 = no filter)"},"end_date_after":{"type":"string","title":"End Date After","default":"","examples":["2025-01-01T00:00:00Z"],"maxLength":100,"description":"Filter markets ending after this datetime (ISO 8601)"},"end_date_before":{"type":"string","title":"End Date Before","default":"","examples":["2025-12-31T23:59:59Z"],"maxLength":100,"description":"Filter markets ending before this datetime (ISO 8601)"},"min_volume_24hr":{"type":"number","title":"Min Volume 24Hr","default":-1,"minimum":-1,"description":"Minimum 24h volume filter (-1 = no filter)"},"max_open_interest":{"type":"number","title":"Max Open Interest","default":-1,"minimum":-1,"description":"Maximum open interest filter (-1 = no limit)"},"min_open_interest":{"type":"number","title":"Min Open Interest","default":-1,"minimum":-1,"description":"Minimum open interest filter (-1 = no filter)"},"max_unique_traders_24h":{"type":"integer","title":"Max Unique Traders 24H","default":-1,"minimum":-1,"description":"Maximum unique traders in 24h (-1 = no limit)"}},"description":"Request for market screener endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"MarketScreenerResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"MarketScreenerItem","required":["market_id"],"properties":{"slug":{"anyOf":[{"type":"string"}],"title":"Slug","description":"URL slug"},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}}],"title":"Tags","description":"Market tags"},"active":{"anyOf":[{"type":"boolean"}],"title":"Active","description":"Whether market is active"},"closed":{"anyOf":[{"type":"boolean"}],"title":"Closed","description":"Whether market is closed"},"volume":{"anyOf":[{"type":"number"}],"title":"Volume","description":"Total volume (USD)"},"best_ask":{"anyOf":[{"type":"number"}],"title":"Best Ask","description":"Best ask price"},"best_bid":{"anyOf":[{"type":"number"}],"title":"Best Bid","description":"Best bid price"},"end_date":{"anyOf":[{"type":"string","format":"date-time"}],"title":"End Date","description":"Market end date"},"event_id":{"anyOf":[{"type":"string"}],"title":"Event Id","description":"Parent event ID"},"neg_risk":{"anyOf":[{"type":"boolean"}],"title":"Neg Risk","description":"Uses neg-risk framework"},"question":{"anyOf":[{"type":"string"}],"title":"Question","description":"Market question"},"age_hours":{"anyOf":[{"type":"number"}],"title":"Age Hours","description":"Market age in hours"},"liquidity":{"anyOf":[{"type":"number"}],"title":"Liquidity","description":"Current liquidity (USD)"},"market_id":{"type":"string","title":"Market Id","examples":["654412"],"description":"Market ID"},"created_at":{"anyOf":[{"type":"string","format":"date-time"}],"title":"Created At","description":"Market creation time"},"volume_1mo":{"anyOf":[{"type":"number"}],"title":"Volume 1Mo","description":"1 month volume (USD)"},"volume_1wk":{"anyOf":[{"type":"number"}],"title":"Volume 1Wk","description":"1 week volume (USD)"},"event_title":{"anyOf":[{"type":"string"}],"title":"Event Title","description":"Parent event title"},"volume_24hr":{"anyOf":[{"type":"number"}],"title":"Volume 24Hr","description":"24h volume (USD)"},"open_interest":{"anyOf":[{"type":"number"}],"title":"Open Interest","description":"Open interest (USD)"},"last_trade_price":{"anyOf":[{"type":"number"}],"title":"Last Trade Price","description":"Last trade price"},"volume_change_pct":{"anyOf":[{"type":"number"}],"title":"Volume Change Pct","description":"Volume change percentage"},"unique_traders_24h":{"anyOf":[{"type":"integer"}],"title":"Unique Traders 24H","description":"Unique traders in 24h"},"one_day_price_change":{"anyOf":[{"type":"number"}],"title":"One Day Price Change","description":"24h price change"}},"description":"Market screener data from ch_api_pm_market_screener."},"title":"Data","description":"List of market screener records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response for market screener endpoint."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QK630vcmpwtuE6THzgYNx","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Browse, filter, and sort Polymarket prediction markets by volume, liquidity, price, status, and more","exampleAgentPrompt":"Show me the top 20 most actively traded Polymarket prediction markets right now — filter to only active ones and sort by 24-hour volume descending, tagging anything related to crypto or Bitcoin.","exampleUseCases":null,"resultDescription":"A paginated list of prediction market items, each including market ID, question text, event title, slug, active/closed status, volume (24hr/1wk/1mo/total), liquidity, open interest, unique traders, best bid/ask prices, neg-risk flag, market age in hours, creation date, end date, and associated tags.","failureModes":["Invalid sort_by or order_by field enum value returns 422 validation error","min_price or max_price below -1 returns validation error","Pagination page below 1 or per_page above 1000 returns validation error","Empty results array when no markets match the filter criteria","Query string exceeding 200 characters returns validation error","Tags array exceeding 50 items returns validation error","Payment failure or insufficient USDC balance returns 402 error"],"whenToPreferThis":"Use this endpoint when you need to discover, browse, or rank Polymarket prediction markets across any topic — especially when sorting or filtering by trading activity metrics like 24hr volume, liquidity, or open interest. Prefer this over the Event Screener when you need market-level granularity rather than event-level aggregates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:18.302Z","isFirstParty":false,"canonicalSlug":"nansen-market-screener-047f8daa"}