{"uid":"cap_agL68mHArL3j7sm2D__bR","slug":"api-nansen-ai-1c28192d","name":"Nansen Prediction Market Event Screener","description":"Get Prediction Market Event Screener","url":"https://api.nansen.ai/api/v1/prediction-market/event-screener","method":"GET","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":"SortOrder[ScreenerSortField]","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":{"request":{"tags":[],"query":"bitcoin","status":"active","sort_by":"volume","neg_risk":false,"max_liquidity":-1,"min_liquidity":500,"min_volume_24hr":50,"max_open_interest":-1,"min_open_interest":100},"response":{"_truncated":true,"_originalSize":31747}},"exampleRequest":{"tags":[],"query":"bitcoin","status":"active","sort_by":"volume","neg_risk":false,"max_liquidity":-1,"min_liquidity":500,"min_volume_24hr":50,"max_open_interest":-1,"min_open_interest":100},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oB0hU-cEzuRh8jzCF-uh3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens and filters prediction market events using Nansen's smart money analytics to surface relevant trading opportunities","exampleAgentPrompt":"Can you pull up the current prediction market event screener from Nansen and show me what events are active right now, especially anything with significant smart money activity?","exampleUseCases":null,"resultDescription":"A list of prediction market events with associated metadata, market statistics, and smart money signals — including event names, categories, liquidity, volume, and any Nansen-labeled wallet activity to help identify high-conviction opportunities.","failureModes":["Invalid or missing filter parameters return 400 bad request","Authentication failure returns 401 if API key is invalid","No events matching filters returns empty result set","Rate limiting or payment failure returns 402 or 429","Server error returns 500 if upstream data pipeline is unavailable"],"whenToPreferThis":"Use this endpoint when you need to discover and screen prediction market events with the backing of Nansen's smart money wallet labels and on-chain flow analytics — particularly when looking for events that smart money wallets are actively participating in. Prefer this over generic prediction market APIs when Nansen's labeling intelligence is needed to filter signal from noise.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:59:32.495Z","isFirstParty":false}