{"uid":"cap_76JHfRvB7vQqqZVxsC-Jx","slug":"api-nansen-ai-549b2e80","name":"Nansen Prediction Market Screener","description":"Get Prediction Market Screener","url":"https://api.nansen.ai/api/v1/prediction-market/market-screener","method":"GET","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":"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"},"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":{"request":{"sort_by":"open_interest","order_by":[{"field":"open_interest","direction":"DESC"}],"pagination":{"page":1,"per_page":10},"min_liquidity":10000,"end_date_after":"2025-06-01T00:00:00Z","min_volume_24hr":5000},"response":{"data":[{"slug":"will-jd-vance-win-the-2028-us-presidential-election","tags":["World Elections","Global Elections","US Election","Elections","Politics","Earn 4%","President","United States","Main Election"],"active":true,"closed":false,"volume":13687918.937718898,"best_ask":0.168,"best_bid":0.166,"end_date":"2028-11-07T00:00:00","event_id":"31552","neg_risk":true,"question":"Will JD Vance win the 2028 US Presidential Election?","age_hours":8265,"liquidity":686329.28237,"market_id":"561229","created_at":"2025-07-08T19:05:57.953000","volume_1mo":1600567.3212670002,"volume_1wk":192852.0356170001,"event_title":"Presidential Election Winner 2028","volume_24hr":14634.861231999996,"open_interest":115554166.415206,"last_trade_price":0.166,"volume_change_pct":-46.9,"unique_traders_24h":82,"one_day_price_change":0.0055},{"slug":"will-argentina-win-the-2026-fifa-world-cup-245","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":58561393.01064399,"best_ask":0.116,"best_bid":0.115,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will Argentina win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":5195826.42002,"market_id":"558938","created_at":"2025-07-02T16:54:43.302000","volume_1mo":40018931.670586586,"volume_1wk":24257353.21035286,"event_title":"World Cup Winner ","volume_24hr":2868251.410843002,"open_interest":74946155.160916,"last_trade_price":0.116,"volume_change_pct":-17.2,"unique_traders_24h":1686,"one_day_price_change":0.008},{"slug":"will-france-win-the-2026-fifa-world-cup-924","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":59343421.565134905,"best_ask":0.185,"best_bid":0.184,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will France win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":4425430.49149,"market_id":"558936","created_at":"2025-07-02T16:54:42.081000","volume_1mo":32044938.51962826,"volume_1wk":15790385.028789919,"event_title":"World Cup Winner ","volume_24hr":1368897.4373860017,"open_interest":63464262.841778,"last_trade_price":0.185,"volume_change_pct":-39.3,"unique_traders_24h":1710,"one_day_price_change":0},{"slug":"will-japan-win-the-2026-fifa-world-cup-112","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":57463931.20306807,"best_ask":0.017,"best_bid":0.016,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will Japan win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":2464144.06243,"market_id":"558949","created_at":"2025-07-02T16:54:49.807000","volume_1mo":35358200.76755424,"volume_1wk":17765900.578535117,"event_title":"World Cup Winner ","volume_24hr":1602623.7131179976,"open_interest":62758975.628304,"last_trade_price":0.017,"volume_change_pct":-36.9,"unique_traders_24h":447,"one_day_price_change":0},{"slug":"will-portugal-win-the-2026-fifa-world-cup-912","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":54045241.95778658,"best_ask":0.081,"best_bid":0.08,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will Portugal win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":2792759.54655,"market_id":"558940","created_at":"2025-07-02T16:54:44.492000","volume_1mo":33799150.12912266,"volume_1wk":15399927.522555184,"event_title":"World Cup Winner ","volume_24hr":3592401.149242996,"open_interest":62473464.193412,"last_trade_price":0.08,"volume_change_pct":63.3,"unique_traders_24h":2122,"one_day_price_change":-0.02},{"slug":"will-usa-win-the-2026-fifa-world-cup-467","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":76777404.02793889,"best_ask":0.023,"best_bid":0.022,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will USA win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":3278690.60295,"market_id":"558943","created_at":"2025-07-02T16:54:46.301000","volume_1mo":44426610.01087611,"volume_1wk":20811472.39555432,"event_title":"World Cup Winner ","volume_24hr":1423653.6000840021,"open_interest":61721237.037782,"last_trade_price":0.023,"volume_change_pct":-52.1,"unique_traders_24h":498,"one_day_price_change":0},{"slug":"will-spain-win-the-2026-fifa-world-cup-963","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":53177458.50019177,"best_ask":0.138,"best_bid":0.137,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will Spain win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":5242844.56139,"market_id":"558934","created_at":"2025-07-02T16:54:40.860000","volume_1mo":31633524.895871863,"volume_1wk":16349042.049883107,"event_title":"World Cup Winner ","volume_24hr":2103694.0203780015,"open_interest":61643275.17537,"last_trade_price":0.138,"volume_change_pct":-9.9,"unique_traders_24h":1305,"one_day_price_change":0.005},{"slug":"will-south-korea-win-the-2026-fifa-world-cup-485","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":79319456.62286136,"best_ask":0.004,"best_bid":0.003,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will South Korea win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":5070367.78076,"market_id":"558961","created_at":"2025-07-02T16:54:56.391000","volume_1mo":54753286.34178805,"volume_1wk":31270075.31512898,"event_title":"World Cup Winner ","volume_24hr":1838934.1062679999,"open_interest":61521780.853588,"last_trade_price":0.003,"volume_change_pct":-58.8,"unique_traders_24h":278,"one_day_price_change":0},{"slug":"will-england-win-the-2026-fifa-world-cup-937","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":45065415.86170632,"best_ask":0.129,"best_bid":0.128,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will England win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":3422911.62863,"market_id":"558935","created_at":"2025-07-02T16:54:41.473000","volume_1mo":27364499.58842697,"volume_1wk":12969287.106767097,"event_title":"World Cup Winner ","volume_24hr":3062024.6634020014,"open_interest":61497285.131004,"last_trade_price":0.129,"volume_change_pct":65.3,"unique_traders_24h":1360,"one_day_price_change":0.024},{"slug":"will-germany-win-the-2026-fifa-world-cup-467","tags":["Soccer","Sports","FIFA World Cup","2026 FIFA World Cup","Hide From New","Tournament Futures"],"active":true,"closed":false,"volume":51601069.04847008,"best_ask":0.057,"best_bid":0.056,"end_date":"2026-07-20T00:00:00","event_id":"30615","neg_risk":true,"question":"Will Germany win the 2026 FIFA World Cup?","age_hours":8412,"liquidity":4455568.97271,"market_id":"558939","created_at":"2025-07-02T16:54:43.890000","volume_1mo":34319054.7727514,"volume_1wk":16270773.769257085,"event_title":"World Cup Winner ","volume_24hr":1046836.7246439985,"open_interest":61440868.202044,"last_trade_price":0.057,"volume_change_pct":-55,"unique_traders_24h":887,"one_day_price_change":0}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"sort_by":"open_interest","order_by":[{"field":"open_interest","direction":"DESC"}],"pagination":{"page":1,"per_page":10},"min_liquidity":10000,"end_date_after":"2025-06-01T00:00:00Z","min_volume_24hr":5000},"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_e6hioAOMtAn5T8_m3wtRS","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":"Screen and filter prediction markets by price, liquidity, volume, open interest, status, tags, and other criteria","exampleAgentPrompt":"Show me active prediction markets on Nansen with at least $10,000 in liquidity and at least $5,000 in 24h volume, filtered to markets ending after 2025-06-01, sorted by open interest descending.","exampleUseCases":null,"resultDescription":"A paginated list of prediction markets matching the filter criteria, including market metadata such as price, liquidity, open interest, 24h volume, unique traders, status, tags, and end date.","failureModes":["Invalid status value returns 400 or empty results","Invalid sort_by field returns error","Date string not in ISO 8601 format causes parse error","Pagination out of bounds returns empty list","Payment not included or insufficient results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to discover, filter, or rank prediction markets based on quantitative criteria like liquidity, volume, price range, or open interest — especially when leveraging Nansen's smart money analytics layer. Prefer this over generic prediction market APIs when wallet-label-enriched or smart-money-flow context is relevant.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:34:51.302Z","isFirstParty":false}