{"openapi":"3.1.0","info":{"title":"Polymarket API","version":"1.0.0","description":"Live prediction-market data from Polymarket, the largest real-money prediction market, via its public Gamma API. On Polymarket people trade shares in the outcome of real-world events, so each market's price is a live, money-backed probability. Get the most active markets, each with its outcomes and their implied probabilities, the best bid and ask, the traded volume and the liquidity. Read one market in full, including its description and resolution date. Pull the biggest events — an event groups related markets, like a championship with one market per team — with their total volume and market count. Get one event with every sub-market and its current probability, the whole field at a glance. Live, no key, nothing stored. Distinct from sports-betting-odds and price-feed APIs — this is Polymarket's money-backed event probabilities and its markets. Perfect for forecasting, trading-signal, news and analytics apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/polymarket-api","description":"oanor gateway"}],"tags":[{"name":"Markets"},{"name":"Events"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/market":{"get":{"operationId":"get_v1_market","tags":["Markets"],"summary":"One market in full","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Polymarket market id","schema":{"type":"string"},"example":"703258"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"703258","slug":"will-jesus-christ-return-before-2027","active":true,"closed":false,"source":"Polymarket","best_ask":0.022,"best_bid":0.021,"end_date":"2026-12-31T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":2.15},{"outcome":"No","probability_pct":97.85}],"question":"Will Jesus Christ return before 2027?","start_date":"2025-11-25T18:08:21.296Z","volume_usd":63651490.63,"description":"This market will resolve to \"Yes\" if The Second Coming of Jesus Christ occurs by December 31, 2026, 11:59 PM ET. Otherwise, this market will resolve to \"No\".\n\nThe resolution source for this market will be a consensus of credible sources.","liquidity_usd":787286.16,"last_trade_price":0.022},"meta":{"timestamp":"2026-06-10T14:02:18.211Z","request_id":"81e4d832-89ca-40c0-a9aa-ffa2ab7b624b"},"status":"ok","message":"Market retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/markets":{"get":{"operationId":"get_v1_markets","tags":["Markets"],"summary":"Most active markets with probabilities","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"volume or liquidity","schema":{"type":"string"},"example":"volume"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"volume","count":25,"source":"Polymarket","markets":[{"id":"703258","slug":"will-jesus-christ-return-before-2027","active":true,"closed":false,"best_ask":0.022,"best_bid":0.021,"end_date":"2026-12-31T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":2.15},{"outcome":"No","probability_pct":97.85}],"question":"Will Jesus Christ return before 2027?","volume_usd":63651490.63,"liquidity_usd":787286.16,"last_trade_price":0.022},{"id":"558960","slug":"will-uzbekistan-win-the-2026-fifa-world-cup-773","active":true,"closed":false,"best_ask":0.001,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.05},{"outcome":"No","probability_pct":99.95}],"question":"Will Uzbekistan win the 2026 FIFA World Cup?","volume_usd":59009947.19,"liquidity_usd":11183243.86,"last_trade_price":0.001},{"id":"558981","slug":"will-congo-dr-win-the-2026-fifa-world-cup","active":true,"closed":false,"best_ask":0.002,"best_bid":0.001,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.15},{"outcome":"No","probability_pct":99.85}],"question":"Will Congo DR win the 2026 FIFA World Cup?","volume_usd":56485232.68,"liquidity_usd":9328785.45,"last_trade_price":0.001},{"id":"558943","slug":"will-usa-win-the-2026-fifa-world-cup-467","active":true,"closed":false,"best_ask":0.012,"best_bid":0.011,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":1.15},{"outcome":"No","probability_pct":98.85}],"question":"Will USA win the 2026 FIFA World Cup?","volume_usd":54180097.12,"liquidity_usd":5591168.85,"last_trade_price":0.011},{"id":"559687","slug":"will-oprah-winfrey-win-the-2028-democratic-presidential-nomination","active":true,"closed":false,"best_ask":0.008,"best_bid":0.007,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.75},{"outcome":"No","probability_pct":99.25}],"question":"Will Oprah Winfrey win the 2028 Democratic presidential nomination?","volume_usd":53010498.97,"liquidity_usd":2649142.19,"last_trade_price":0.007},{"id":"561251","slug":"will-lebron-james-win-the-2028-us-presidential-election","active":true,"closed":false,"best_ask":0.007,"best_bid":0.006,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.65},{"outcome":"No","probability_pct":99.35}],"question":"Will LeBron James win the 2028 US Presidential Election?","volume_usd":52360591.54,"liquidity_usd":2303765.7,"last_trade_price":0.006},{"id":"958443","slug":"will-the-iranian-regime-fall-by-june-30","active":true,"closed":false,"best_ask":0.016,"best_bid":0.015,"end_date":"2026-06-30T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":1.55},{"outcome":"No","probability_pct":98.45}],"question":"Will the Iranian regime fall by June 30?","volume_usd":51213053.22,"liquidity_usd":729974.1,"last_trade_price":0.015},{"id":"558966","slug":"will-ivory-coast-win-the-2026-fifa-world-cup","active":true,"closed":false,"best_ask":0.005,"best_bid":0.004,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.45},{"outcome":"No","probability_pct":99.55}],"question":"Will Ivory Coast win the 2026 FIFA World Cup?","volume_usd":50525713.96,"liquidity_usd":6242204.29,"last_trade_price":0.005},{"id":"559679","slug":"will-bernie-sanders-win-the-2028-democratic-presidential-nomination-879","active":true,"closed":false,"best_ask":0.008,"best_bid":0.007,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.75},{"outcome":"No","probability_pct":99.25}],"question":"Will Bernie Sanders win the 2028 Democratic presidential nomination?","volume_usd":50325927.62,"liquidity_usd":1488965.68,"last_trade_price":0.007},{"id":"558968","slug":"will-egypt-win-the-2026-fifa-world-cup","active":true,"closed":false,"best_ask":0.003,"best_bid":0.002,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.25},{"outcome":"No","probability_pct":99.75}],"question":"Will Egypt win the 2026 FIFA World Cup?","volume_usd":49859348.15,"liquidity_usd":6170887.21,"last_trade_price":0.002},{"id":"559684","slug":"will-chelsea-clinton-win-the-2028-democratic-presidential-nomination","active":true,"closed":false,"best_ask":0.01,"best_bid":0.009,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.95},{"outcome":"No","probability_pct":99.05}],"question":"Will Chelsea Clinton win the 2028 Democratic presidential nomination?","volume_usd":49451263.21,"liquidity_usd":534604.31,"last_trade_price":0.009},{"id":"559688","slug":"will-andrew-yang-win-the-2028-democratic-presidential-nomination","active":true,"closed":false,"best_ask":0.007,"best_bid":0.006,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.65},{"outcome":"No","probability_pct":99.35}],"question":"Will Andrew Yang win the 2028 Democratic presidential nomination?","volume_usd":46706646.1,"liquidity_usd":2465360.88,"last_trade_price":0.006},{"id":"558972","slug":"will-saudi-arabia-win-the-2026-fifa-world-cup","active":true,"closed":false,"best_ask":0.001,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.05},{"outcome":"No","probability_pct":99.95}],"question":"Will Saudi Arabia win the 2026 FIFA World Cup?","volume_usd":46465588.43,"liquidity_usd":11650791.45,"last_trade_price":0.001},{"id":"558961","slug":"will-south-korea-win-the-2026-fifa-world-cup-485","active":true,"closed":false,"best_ask":0.003,"best_bid":0.002,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.25},{"outcome":"No","probability_pct":99.75}],"question":"Will South Korea win the 2026 FIFA World Cup?","volume_usd":46274016.46,"liquidity_usd":4625990.33,"last_trade_price":0.003},{"id":"558957","slug":"will-new-zealand-win-the-2026-fifa-world-cup-635","active":true,"closed":false,"best_ask":0.001,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.05},{"outcome":"No","probability_pct":99.95}],"question":"Will New Zealand win the 2026 FIFA World Cup?","volume_usd":45343921.61,"liquidity_usd":16166822.13,"last_trade_price":0.001},{"id":"558958","slug":"will-australia-win-the-2026-fifa-world-cup-816","active":true,"closed":false,"best_ask":0.002,"best_bid":0.001,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.15},{"outcome":"No","probability_pct":99.85}],"question":"Will Australia win the 2026 FIFA World Cup?","volume_usd":45005617.97,"liquidity_usd":14243551.17,"last_trade_price":0.001},{"id":"558976","slug":"will-croatia-win-the-2026-fifa-world-cup","active":true,"closed":false,"best_ask":0.01,"best_bid":0.009,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.95},{"outcome":"No","probability_pct":99.05}],"question":"Will Croatia win the 2026 FIFA World Cup?","volume_usd":43757983.19,"liquidity_usd":2806917.21,"last_trade_price":0.01},{"id":"561986","slug":"will-byron-donalds-win-the-2028-republican-presidential-nomination","active":true,"closed":false,"best_ask":0.008,"best_bid":0.007,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.75},{"outcome":"No","probability_pct":99.25}],"question":"Will Byron Donalds win the 2028 Republican presidential nomination?","volume_usd":43487617.84,"liquidity_usd":1649060.79,"last_trade_price":0.008},{"id":"558959","slug":"will-iran-win-the-2026-fifa-world-cup-788","active":true,"closed":false,"best_ask":0.002,"best_bid":0.001,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.15},{"outcome":"No","probability_pct":99.85}],"question":"Will Iran win the 2026 FIFA World Cup?","volume_usd":43196307.8,"liquidity_usd":9374252.98,"last_trade_price":0.001},{"id":"558955","slug":"will-ecuador-win-the-2026-fifa-world-cup-986","active":true,"closed":false,"best_ask":0.009,"best_bid":0.008,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.85},{"outcome":"No","probability_pct":99.15}],"question":"Will Ecuador win the 2026 FIFA World Cup?","volume_usd":42934931.41,"liquidity_usd":4130835.14,"last_trade_price":0.008},{"id":"558936","slug":"will-france-win-the-2026-fifa-world-cup-924","active":true,"closed":false,"best_ask":0.161,"best_bid":0.16,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":16.05},{"outcome":"No","probability_pct":83.95}],"question":"Will France win the 2026 FIFA World Cup?","volume_usd":42729871.37,"liquidity_usd":1151108.04,"last_trade_price":0.161},{"id":"558952","slug":"will-canada-win-the-2026-fifa-world-cup-755","active":true,"closed":false,"best_ask":0.004,"best_bid":0.003,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.35},{"outcome":"No","probability_pct":99.65}],"question":"Will Canada win the 2026 FIFA World Cup?","volume_usd":42652484.26,"liquidity_usd":7229259.22,"last_trade_price":0.004},{"id":"559677","slug":"will-hillary-clinton-win-the-2028-democratic-presidential-nomination","active":true,"closed":false,"best_ask":0.008,"best_bid":0.007,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.75},{"outcome":"No","probability_pct":99.25}],"question":"Will Hillary Clinton win the 2028 Democratic presidential nomination?","volume_usd":42643780.02,"liquidity_usd":1667141.88,"last_trade_price":0.007},{"id":"558969","slug":"will-algeria-win-the-2026-fifa-world-cup","active":true,"closed":false,"best_ask":0.002,"best_bid":0.001,"end_date":"2026-07-20T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.15},{"outcome":"No","probability_pct":99.85}],"question":"Will Algeria win the 2026 FIFA World Cup?","volume_usd":42545398.49,"liquidity_usd":5009620.59,"last_trade_price":0.002},{"id":"561247","slug":"will-tim-walz-win-the-2028-us-presidential-election","active":true,"closed":false,"best_ask":0.007,"best_bid":0.006,"end_date":"2028-11-07T00:00:00Z","outcomes":[{"outcome":"Yes","probability_pct":0.65},{"outcome":"No","probability_pct":99.35}],"question":"Will Tim Walz win the 2028 US Presidential Election?","volume_usd":42307358.85,"liquidity_usd":1908947.34,"last_trade_price":0.006}]},"meta":{"timestamp":"2026-06-10T14:02:18.384Z","request_id":"40957bb8-12b7-4807-b83c-14ba233b0f54"},"status":"ok","message":"Markets retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/event":{"get":{"operationId":"get_v1_event","tags":["Events"],"summary":"One event + every sub-market probability","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Polymarket event id","schema":{"type":"string"},"example":"30615"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"30615","slug":"world-cup-winner","title":"World Cup Winner ","source":"Polymarket","markets":[{"id":"558934","question":"Will Spain win the 2026 FIFA World Cup?","volume_usd":35686861.16,"probability_pct":16.35},{"id":"558936","question":"Will France win the 2026 FIFA World Cup?","volume_usd":42729871.37,"probability_pct":16.05},{"id":"558940","question":"Will Portugal win the 2026 FIFA World Cup?","volume_usd":37042929.43,"probability_pct":10.95},{"id":"558935","question":"Will England win the 2026 FIFA World Cup?","volume_usd":30906456.24,"probability_pct":10.85},{"id":"558938","question":"Will Argentina win the 2026 FIFA World Cup?","volume_usd":32421221.42,"probability_pct":8.55},{"id":"558937","question":"Will Brazil win the 2026 FIFA World Cup?","volume_usd":32309036.87,"probability_pct":8.45},{"id":"558939","question":"Will Germany win the 2026 FIFA World Cup?","volume_usd":34607262.31,"probability_pct":5.25},{"id":"558941","question":"Will Netherlands win the 2026 FIFA World Cup?","volume_usd":36567087.95,"probability_pct":4.05},{"id":"558951","question":"Will Norway win the 2026 FIFA World Cup?","volume_usd":36149011.82,"probability_pct":2.45},{"id":"558946","question":"Will Belgium win the 2026 FIFA World Cup?","volume_usd":37733121.27,"probability_pct":2.15},{"id":"558947","question":"Will Colombia win the 2026 FIFA World Cup?","volume_usd":37193361.55,"probability_pct":1.95},{"id":"558949","question":"Will Japan win the 2026 FIFA World Cup?","volume_usd":38818836.65,"probability_pct":1.75},{"id":"558963","question":"Will Morocco win the 2026 FIFA World Cup?","volume_usd":41611869.51,"probability_pct":1.75},{"id":"558945","question":"Will Mexico win the 2026 FIFA World Cup?","volume_usd":42016826.11,"probability_pct":1.35},{"id":"558974","question":"Will Switzerland win the 2026 FIFA World Cup?","volume_usd":36084058.98,"probability_pct":1.15},{"id":"558943","question":"Will USA win the 2026 FIFA World Cup?","volume_usd":54180097.12,"probability_pct":1.15},{"id":"558985","question":"Will Turkiye win the 2026 FIFA World Cup?","volume_usd":35077224.56,"probability_pct":1.15},{"id":"558944","question":"Will Uruguay win the 2026 FIFA World Cup?","volume_usd":37831236.78,"probability_pct":1.05},{"id":"558976","question":"Will Croatia win the 2026 FIFA World Cup?","volume_usd":43757983.19,"probability_pct":0.95},{"id":"558955","question":"Will Ecuador win the 2026 FIFA World Cup?","volume_usd":42934931.41,"probability_pct":0.85},{"id":"558965","question":"Will Senegal win the 2026 FIFA World Cup?","volume_usd":37086752.29,"probability_pct":0.65},{"id":"558966","question":"Will Ivory Coast win the 2026 FIFA World Cup?","volume_usd":50525713.96,"probability_pct":0.45},{"id":"558975","question":"Will Austria win the 2026 FIFA World Cup?","volume_usd":41734949.32,"probability_pct":0.45},{"id":"558952","question":"Will Canada win the 2026 FIFA World Cup?","volume_usd":42652484.26,"probability_pct":0.35},{"id":"558980","question":"Will Sweden win the 2026 FIFA World Cup?","volume_usd":28102745.95,"probability_pct":0.35},{"id":"558961","question":"Will South Korea win the 2026 FIFA World Cup?","volume_usd":46274016.46,"probability_pct":0.25},{"id":"558956","question":"Will Paraguay win the 2026 FIFA World Cup?","volume_usd":35866599.6,"probability_pct":0.25},{"id":"558973","question":"Will Scotland win the 2026 FIFA World Cup?","volume_usd":39704437.15,"probability_pct":0.25},{"id":"558984","question":"Will Czechia win the 2026 FIFA World Cup?","volume_usd":25306074.13,"probability_pct":0.25},{"id":"558968","question":"Will Egypt win the 2026 FIFA World Cup?","volume_usd":49859348.15,"probability_pct":0.25},{"id":"558959","question":"Will Iran win the 2026 FIFA World Cup?","volume_usd":43196307.8,"probability_pct":0.15},{"id":"558967","question":"Will Ghana win the 2026 FIFA World Cup?","volume_usd":35433182.14,"probability_pct":0.15},{"id":"558969","question":"Will Algeria win the 2026 FIFA World Cup?","volume_usd":42545398.49,"probability_pct":0.15},{"id":"558983","question":"Will Bosnia-Herzegovina win the 2026 FIFA World Cup?","volume_usd":25730141.88,"probability_pct":0.15},{"id":"558981","question":"Will Congo DR win the 2026 FIFA World Cup?","volume_usd":56485232.68,"probability_pct":0.15},{"id":"558958","question":"Will Australia win the 2026 FIFA World Cup?","volume_usd":45005617.97,"probability_pct":0.15},{"id":"558957","question":"Will New Zealand win the 2026 FIFA World Cup?","volume_usd":45343921.61,"probability_pct":0.05},{"id":"558977","question":"Will Haiti win the 2026 FIFA World Cup?","volume_usd":31940310.57,"probability_pct":0.05},{"id":"558962","question":"Will Jordan win the 2026 FIFA World Cup?","volume_usd":31415072.44,"probability_pct":0.05},{"id":"558978","question":"Will Curaçao win the 2026 FIFA World Cup?","volume_usd":41464203.68,"probability_pct":0.05},{"id":"558954","question":"Will Tunisia win the 2026 FIFA World Cup?","volume_usd":35370230.04,"probability_pct":0.05},{"id":"558960","question":"Will Uzbekistan win the 2026 FIFA World Cup?","volume_usd":59009947.19,"probability_pct":0.05},{"id":"558979","question":"Will Panama win the 2026 FIFA World Cup?","volume_usd":19220318.77,"probability_pct":0.05},{"id":"558982","question":"Will Iraq win the 2026 FIFA World Cup?","volume_usd":28714959.26,"probability_pct":0.05},{"id":"558964","question":"Will South Africa win the 2026 FIFA World Cup?","volume_usd":37808530.21,"probability_pct":0.05},{"id":"558970","question":"Will Cape Verde win the 2026 FIFA World Cup?","volume_usd":40039283.28,"probability_pct":0.05},{"id":"558971","question":"Will Qatar win the 2026 FIFA World Cup?","volume_usd":41726376.53,"probability_pct":0.05},{"id":"558972","question":"Will Saudi Arabia win the 2026 FIFA World Cup?","volume_usd":46465588.43,"probability_pct":0.05},{"id":"558942","question":"Will Italy win the 2026 FIFA World Cup?","volume_usd":8666273.3,"probability_pct":0},{"id":"558948","question":"Will Peru win the 2026 FIFA World Cup?","volume_usd":264589.51,"probability_pct":0},{"id":"558992","question":"Will Team AM win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558988","question":"Will Team AI win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558953","question":"Will Any Other Team win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558986","question":"Will Team AG win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558987","question":"Will Team AH win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558991","question":"Will Team AL win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558993","question":"Will Team AN win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558989","question":"Will Team AJ win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558990","question":"Will Team AK win the 2026 FIFA World Cup?","volume_usd":0},{"id":"558994","question":"Will Team AO win the 2026 FIFA World Cup?","volume_usd":0}],"end_date":"2026-07-20T00:00:00Z","volume_usd":1877501548.55,"market_count":60},"meta":{"timestamp":"2026-06-10T14:02:18.548Z","request_id":"85dbd8ad-0142-43d8-93fc-f21c1d067a24"},"status":"ok","message":"Event retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/events":{"get":{"operationId":"get_v1_events","tags":["Events"],"summary":"Biggest events with volume","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"events":[{"id":"30615","slug":"world-cup-winner","title":"World Cup Winner ","end_date":"2026-07-20T00:00:00Z","volume_usd":1877501548.55,"market_count":60,"liquidity_usd":368432174.42},{"id":"30829","slug":"democratic-presidential-nominee-2028","title":"Democratic Presidential Nominee 2028","end_date":"2028-11-07T00:00:00Z","volume_usd":1191662480.1,"market_count":128,"liquidity_usd":66260142.01},{"id":"31875","slug":"republican-presidential-nominee-2028","title":"Republican Presidential Nominee 2028","end_date":"2028-11-07T00:00:00Z","volume_usd":654912804.85,"market_count":128,"liquidity_usd":46034429.63},{"id":"31552","slug":"presidential-election-winner-2028","title":"Presidential Election Winner 2028","end_date":"2028-11-07T00:00:00Z","volume_usd":623650873.28,"market_count":128,"liquidity_usd":35787468.22},{"id":"27830","slug":"2026-nba-champion","title":"2026 NBA Champion","end_date":"2026-07-01T00:00:00Z","volume_usd":418416818.48,"market_count":30,"liquidity_usd":903065.63},{"id":"357807","slug":"us-x-iran-permanent-peace-deal-by","title":"US x Iran permanent peace deal by...?","end_date":"2026-12-31T00:00:00Z","volume_usd":278762611.85,"market_count":17,"liquidity_usd":2118830.82},{"id":"100371","slug":"2026-f1-drivers-champion","title":"F1 Drivers' Champion","end_date":"2026-12-06T00:00:00Z","volume_usd":170330051.2,"market_count":32,"liquidity_usd":12835480.43},{"id":"34051","slug":"netanyahu-out-before-2027","title":"Netanyahu out by...?","end_date":"2026-12-31T00:00:00Z","volume_usd":122033526.87,"market_count":5,"liquidity_usd":123304.54},{"id":"45915","slug":"brazil-presidential-election","title":"Brazil Presidential Election","end_date":"2026-10-04T00:00:00Z","volume_usd":97543777.67,"market_count":32,"liquidity_usd":9273922.41},{"id":"79987","slug":"next-french-presidential-election","title":"Next French Presidential Election","end_date":"2027-04-30T00:00:00Z","volume_usd":95698277.7,"market_count":128,"liquidity_usd":9577125.15},{"id":"106520","slug":"peru-presidential-election-winner","title":"Peru Presidential Election Winner","end_date":"2026-04-12T00:00:00Z","volume_usd":93443987.21,"market_count":49,"liquidity_usd":10871977.24},{"id":"143443","slug":"venezuela-leader-end-of-2026","title":"Venezuela leader end of 2026?","end_date":"2026-12-31T00:00:00Z","volume_usd":90512526.42,"market_count":57,"liquidity_usd":1441797.39},{"id":"27829","slug":"2026-nhl-stanley-cup-champion","title":"2026 NHL Stanley Cup Champion ","end_date":"2026-06-30T00:00:00Z","volume_usd":82223640.88,"market_count":32,"liquidity_usd":455295.53},{"id":"101772","slug":"fed-decision-in-june-825","title":"Fed Decision in June?","end_date":"2026-06-17T00:00:00Z","volume_usd":77585854.78,"market_count":5,"liquidity_usd":4626631.79},{"id":"438327","slug":"iran-closes-its-airspace-by","title":"Iran closes its airspace by...?","end_date":"2026-05-31T00:00:00Z","volume_usd":68082405.2,"market_count":15,"liquidity_usd":8556938.77},{"id":"90178","slug":"will-jesus-christ-return-before-2027","title":"Will Jesus Christ return before 2027?","end_date":"2026-12-31T00:00:00Z","volume_usd":63651390.63,"market_count":1,"liquidity_usd":786736.86},{"id":"267102","slug":"kharg-island-no-longer-under-iranian-control-by-march-31","title":"Kharg Island no longer under Iranian control by...?","end_date":"2026-03-31T23:55:00Z","volume_usd":52268786.32,"market_count":5,"liquidity_usd":187739.25},{"id":"108634","slug":"will-the-iranian-regime-fall-by-june-30","title":"Will the Iranian regime fall by June 30?","end_date":"2026-06-30T00:00:00Z","volume_usd":51212509.64,"market_count":1,"liquidity_usd":742916.93},{"id":"90177","slug":"will-the-us-confirm-that-aliens-exist-before-2027","title":"Will the US confirm that aliens exist by...?","end_date":"2026-12-31T00:00:00Z","volume_usd":50808251.01,"market_count":6,"liquidity_usd":2851066.15},{"id":"371649","slug":"us-x-iran-diplomatic-meeting-by-329","title":"US x Iran diplomatic meeting by...?","end_date":"2026-04-30T00:00:00Z","volume_usd":44579778.56,"market_count":28,"liquidity_usd":377539.31},{"id":"89502","slug":"what-price-will-bitcoin-hit-before-2027","title":"What price will Bitcoin hit in 2026?","end_date":"2027-01-01T05:00:00Z","volume_usd":42191672.17,"market_count":42,"liquidity_usd":1851495.35},{"id":"34584","slug":"colombia-presidential-election","title":"Colombia Presidential Election","end_date":"2026-06-21T14:00:00Z","volume_usd":36306994.83,"market_count":28,"liquidity_usd":4444484.07},{"id":"57096","slug":"california-governor-election-2026","title":"California Governor Election Winner","end_date":"2026-11-03T00:00:00Z","volume_usd":35929542.01,"market_count":45,"liquidity_usd":6123592.24},{"id":"517606","slug":"us-announces-new-iran-agreementceasefire-extension-by","title":"US announces new Iran agreement/ceasefire extension by...?","volume_usd":35550739.66,"market_count":17,"liquidity_usd":357523.25},{"id":"73130","slug":"will-the-us-invade-iran-before-2027","title":"Will the U.S. invade Iran before 2027?","end_date":"2026-12-31T00:00:00Z","volume_usd":35019725.66,"market_count":1,"liquidity_usd":551095.99}],"source":"Polymarket"},"meta":{"timestamp":"2026-06-10T14:02:19.805Z","request_id":"0f43b021-314c-409e-bd82-a4dddc9d9a14"},"status":"ok","message":"Events retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":158000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2800,"monthly_call_quota":890000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":6700,"monthly_call_quota":4850000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/polymarket-api"}