{"uid":"cap_bDeGZhqYgyMZw-h0jEZ0N","slug":"nansen-event-screener-db3fb486","name":"Nansen Polymarket Event Screener","description":"Browse and filter Polymarket events (groups of related markets). Includes aggregated\nvolume, liquidity, and trader counts across all markets in each event.\n\n**What it helps to answer:**\n\n1. **What are the most popular prediction market events?**\n2. **How much total volume does an event have across all its markets?**\n3. **Which events have the most active trading?**","url":"https://api.nansen.ai/api/v1/prediction-market/event-screener?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"EventScreenerRequest","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"},"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 event screener endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"EventScreenerResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"EventScreenerItem","required":["event_id"],"properties":{"tags":{"anyOf":[{"type":"array","items":{"type":"string"}}],"title":"Tags","description":"Event tags"},"markets":{"anyOf":[{"type":"array","items":{"type":"object","title":"EventScreenerMarket","required":["market_id","question"],"properties":{"best_ask":{"anyOf":[{"type":"number"}],"title":"Best Ask"},"best_bid":{"anyOf":[{"type":"number"}],"title":"Best Bid"},"end_date":{"anyOf":[{"type":"string","format":"date-time"}],"title":"End Date"},"question":{"type":"string","title":"Question"},"market_id":{"type":"string","title":"Market Id"},"volume_24hr":{"anyOf":[{"type":"number"}],"title":"Volume 24Hr"},"open_interest":{"anyOf":[{"type":"number"}],"title":"Open Interest"},"last_trade_price":{"anyOf":[{"type":"number"}],"title":"Last Trade Price"},"volume_change_pct":{"anyOf":[{"type":"number"}],"title":"Volume Change Pct"},"unique_traders_24h":{"anyOf":[{"type":"integer"}],"title":"Unique Traders 24H"},"one_day_price_change":{"anyOf":[{"type":"number"}],"title":"One Day Price Change"}},"description":"Single market within an event screener row."}}],"title":"Markets","description":"Nested market data"},"event_id":{"type":"string","title":"Event Id","description":"Event ID"},"neg_risk":{"anyOf":[{"type":"boolean"}],"title":"Neg Risk","description":"Uses neg-risk framework"},"event_title":{"anyOf":[{"type":"string"}],"title":"Event Title","description":"Event title"},"market_count":{"anyOf":[{"type":"integer"}],"title":"Market Count","description":"Number of markets"},"total_volume":{"anyOf":[{"type":"number"}],"title":"Total Volume","description":"Total volume (USD)"},"max_age_hours":{"anyOf":[{"type":"number"}],"title":"Max Age Hours","description":"Max market age in hours"},"top_market_id":{"anyOf":[{"type":"string"}],"title":"Top Market Id","description":"Top market by 24h volume"},"total_liquidity":{"anyOf":[{"type":"number"}],"title":"Total Liquidity","description":"Total liquidity (USD)"},"total_volume_1mo":{"anyOf":[{"type":"number"}],"title":"Total Volume 1Mo","description":"Total 1 month volume (USD)"},"total_volume_1wk":{"anyOf":[{"type":"number"}],"title":"Total Volume 1Wk","description":"Total 1 week volume (USD)"},"total_traders_24h":{"anyOf":[{"type":"integer"}],"title":"Total Traders 24H","description":"Total unique traders in 24h"},"total_volume_24hr":{"anyOf":[{"type":"number"}],"title":"Total Volume 24Hr","description":"Total 24h volume (USD)"},"top_market_question":{"anyOf":[{"type":"string"}],"title":"Top Market Question","description":"Top market question"},"total_open_interest":{"anyOf":[{"type":"number"}],"title":"Total Open Interest","description":"Total open interest (USD)"},"top_market_volume_24hr":{"anyOf":[{"type":"number"}],"title":"Top Market Volume 24Hr","description":"Top market 24h volume"},"total_volume_change_pct":{"anyOf":[{"type":"number"}],"title":"Total Volume Change Pct","description":"Total volume change percentage"}},"description":"Event screener data from ch_api_pm_event_screener."},"title":"Data","description":"List of event 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 event 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_PGirkHSoTitFP17QPctZA","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 market events with aggregated volume, liquidity, and trader statistics across all child markets.","exampleAgentPrompt":"Show me the top 10 most actively traded Polymarket events right now — filter to only active status, sort by 24-hour volume descending, and include crypto-tagged events. Give me the event titles, total volumes, and market counts.","exampleUseCases":null,"resultDescription":"A paginated list of Polymarket events, each with: event ID, title, tags, market count, total volume (USD), 24h volume, weekly/monthly volume, liquidity, open interest, unique trader counts, max age in hours, neg-risk flag, top market ID, and nested data for individual child markets including their questions, best bid/ask prices, last trade price, open interest, 24h volume, and 1-day price change.","failureModes":["Invalid sort_by field value returns validation error","Tags array exceeding 50 items returns 422 unprocessable entity","Query string exceeding 200 characters is rejected","Invalid status enum value returns validation error","min_liquidity greater than max_liquidity returns empty or error","Page number below 1 or per_page above 1000 returns validation error","Unauthorized request (missing/invalid API key) returns 401","No matching events for given filters returns empty data array"],"whenToPreferThis":"Use this endpoint when you need to discover and rank Polymarket prediction market events — especially when you want cross-market aggregates (total event volume, total liquidity, combined trader counts) rather than individual market data. Prefer this over single-market endpoints when comparing events, identifying trending topics, or building leaderboards of prediction market activity. Ideal for broad discovery with filtering by tag, status, or volume thresholds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:41:10.003Z","isFirstParty":false,"canonicalSlug":"nansen-event-screener-db3fb486"}