{"openapi":"3.1.0","info":{"title":"Futuur Prediction Markets API","version":"1.0.0","description":"Live prices from Futuur, a global prediction market where users trade on the outcome of real-world events across crypto, politics, sports, science and economics — in both real money (USDC) and play money — served from the public Futuur API, no key, nothing stored. Each market asks a question (for example \"Which price will Bitcoin hit in 2026?\") and holds two or more outcomes whose price, between 0 and 1, is the market-implied probability of that outcome — an outcome trading at 0.46 means the market prices a 46% chance. The markets endpoint lists markets, filterable by category and search term, each with its outcomes and prices. The market endpoint returns a single market with every outcome's real-money and play-money price (and implied probability) plus its category, status and close date. The categories endpoint lists the topic categories from Bitcoin to elections to sports. Read what a worldwide crowd is pricing in for the future, as live JSON. This is the global prediction-market / event-probability cut — distinct from the US-politics-only (PredictIt) and crypto-only (Polymarket) prediction markets and the price and FX APIs in the catalogue.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/futuur-api","description":"oanor gateway"}],"tags":[{"name":"Markets"},{"name":"Market"},{"name":"Categories"},{"name":"Meta"}],"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/markets":{"get":{"operationId":"get_v1_markets","tags":["Markets"],"summary":"List markets with outcomes and prices","description":"","parameters":[{"name":"search","in":"query","required":false,"description":"Search term","schema":{"type":"string"},"example":"bitcoin"},{"name":"category","in":"query","required":false,"description":"Category id","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max markets (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"Futuur","markets":[{"id":231754,"title":"Which price will Bitcoin hit in 2026?","status":"open","category":"Bitcoin","outcomes":[{"id":570578,"title":"55,000","play_money_price":0.34,"real_money_price":0.46,"implied_probability_pct":46},{"id":570575,"title":"120,000","play_money_price":0.3,"real_money_price":0.1,"implied_probability_pct":10},{"id":570574,"title":"140,000","play_money_price":0.16,"real_money_price":0.02,"implied_probability_pct":2},{"id":570576,"title":"75,000","play_money_price":0.98,"real_money_price":0.99,"implied_probability_pct":99},{"id":570577,"title":"65,000","play_money_price":0.98,"real_money_price":0.99,"implied_probability_pct":99}],"outcome_count":5},{"id":239422,"title":"Which price will Bitcoin hit in June?","status":"open","category":"Bitcoin","outcomes":[{"id":587598,"title":"55,000","play_money_price":0.45,"real_money_price":0.29,"implied_probability_pct":29},{"id":587597,"title":"75,000","play_money_price":0.44,"real_money_price":0.08,"implied_probability_pct":8},{"id":587599,"title":"50,000","play_money_price":0.21,"real_money_price":0.12,"implied_probability_pct":12}],"outcome_count":3},{"id":239423,"title":"Will Bitcoin's price go up or down in June?","status":"open","category":"Bitcoin","outcomes":[{"id":587601,"title":"Will Bitcoin's price go up or down in June?","play_money_price":0.15,"real_money_price":0.2,"implied_probability_pct":20}],"outcome_count":1},{"id":239424,"title":"Will Ether outperform Bitcoin in June?","status":"open","category":"Ethereum","outcomes":[{"id":587602,"title":"Will Ether outperform Bitcoin in June?","play_money_price":0.35,"real_money_price":0.32,"implied_probability_pct":32}],"outcome_count":1},{"id":222360,"title":"Will Brazil constitute a strategic Bitcoin reserve by the end of 2026?","status":"open","category":"Economy","outcomes":[{"id":549121,"title":"Will Brazil constitute a strategic Bitcoin reserve by the end of 2026?","play_money_price":0.25,"real_money_price":0.11,"implied_probability_pct":11}],"outcome_count":1},{"id":231607,"title":"Will any cryptocurrency (other than Bitcoin) surpass the market cap of Ethereum in 2026?","status":"open","category":"Ethereum","outcomes":[{"id":570307,"title":"Will any cryptocurrency (other than Bitcoin) surpass the market cap of Ethereum in 2026?","play_money_price":0.2,"real_money_price":0.16,"implied_probability_pct":16}],"outcome_count":1},{"id":231652,"title":"Will Amazon accept Bitcoin as payment by the end of 2026?","status":"open","category":"Amazon","outcomes":[{"id":570352,"title":"Will Amazon accept Bitcoin as payment by the end of 2026?","play_money_price":0.18,"real_money_price":0.09,"implied_probability_pct":9}],"outcome_count":1},{"id":231597,"title":"Will Bitcoin mining be regulated in the US by the end of 2026?","status":"open","category":"Regulation","outcomes":[{"id":570297,"title":"Will Bitcoin mining be regulated in the US by the end of 2026?","play_money_price":0.32,"real_money_price":0.22,"implied_probability_pct":22}],"outcome_count":1},{"id":231606,"title":"Bitcoin still the largest crypto token in market cap through the end of 2026?","status":"open","category":"Bitcoin","outcomes":[{"id":570306,"title":"Bitcoin still the largest crypto token in market cap through the end of 2026?","play_money_price":0.94,"real_money_price":0.96,"implied_probability_pct":96}],"outcome_count":1},{"id":239444,"title":"What will be the price of Bitcoin at the end of 2026?","status":"open","category":"Bitcoin","outcomes":[{"id":587637,"title":"Below $ 60,000","play_money_price":0.3,"real_money_price":0.3,"implied_probability_pct":30},{"id":587638,"title":"Between $ 60,000 and $ 74,999.99","play_money_price":0.25,"real_money_price":0.25,"implied_probability_pct":25},{"id":587639,"title":"Between $ 75,000 and $ 89,999.99","play_money_price":0.19,"real_money_price":0.19,"implied_probability_pct":19},{"id":587641,"title":"$ 105,000 or higher","play_money_price":0.16,"real_money_price":0.16,"implied_probability_pct":16},{"id":587640,"title":"Between $ 90,000 and $ 104,999.99","play_money_price":0.1,"real_money_price":0.1,"implied_probability_pct":10}],"outcome_count":5}]},"meta":{"timestamp":"2026-06-11T16:46:37.271Z","request_id":"e35a1f29-0144-42c6-8385-ea52a8a4be24"},"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/market":{"get":{"operationId":"get_v1_market","tags":["Market"],"summary":"A single market with all outcomes and odds","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Market id","schema":{"type":"string"},"example":"231754"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":231754,"note":"Prices are 0-1 implied probabilities. real_money_price is the USDC market, play_money_price the OOM market.","title":"Which price will Bitcoin hit in 2026?","source":"Futuur","status":"open","category":"Bitcoin","outcomes":[{"id":570578,"title":"55,000","play_money_price":0.34,"real_money_price":0.46,"implied_probability_pct":46},{"id":570575,"title":"120,000","play_money_price":0.3,"real_money_price":0.1,"implied_probability_pct":10},{"id":570574,"title":"140,000","play_money_price":0.16,"real_money_price":0.02,"implied_probability_pct":2},{"id":570576,"title":"75,000","play_money_price":0.98,"real_money_price":0.99,"implied_probability_pct":99},{"id":570577,"title":"65,000","play_money_price":0.98,"real_money_price":0.99,"implied_probability_pct":99}],"close_date":"2026-12-31T00:00:00Z","outcome_count":5},"meta":{"timestamp":"2026-06-11T16:46:37.562Z","request_id":"5454a68b-dfe9-41b8-9baa-ce46234068ef"},"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/categories":{"get":{"operationId":"get_v1_categories","tags":["Categories"],"summary":"Topic categories","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"source":"Futuur","categories":[{"id":2197,"title":"007"},{"id":3508,"title":"2026 Election"},{"id":3612,"title":"2026 Elections"},{"id":3611,"title":"2028 Elections"},{"id":624,"title":"Africa"},{"id":3042,"title":"AI Regulation"},{"id":3658,"title":"Album releases"},{"id":2130,"title":"Alibaba"},{"id":2650,"title":"Alien Life"},{"id":2131,"title":"Alphabet"},{"id":2729,"title":"Alzheimer's disease"},{"id":2132,"title":"Amazon"},{"id":2133,"title":"Apple"},{"id":122,"title":"Approval Rates"},{"id":1123,"title":"Argentina"},{"id":2349,"title":"Artemis Mission"},{"id":3580,"title":"Artificial Intelligence"},{"id":118,"title":"Asia/Pacific"},{"id":2094,"title":"Average Wage"},{"id":2341,"title":"Belarus"}]},"meta":{"timestamp":"2026-06-11T16:46:37.904Z","request_id":"c208ed53-4399-42e8-8346-14c022011426"},"status":"ok","message":"Categories 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Outcome prices are 0-1 implied probabilities; 0.46 is a 46% chance. real_money_price is the USDC market, play_money_price the OOM market. Get a market id from /v1/markets, then call /v1/market?id=.","source":"Futuur (api.futuur.com/api/v1, live)","service":"futuur-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/market":"A single market with all outcomes, prices and implied probabilities (id=231754).","GET /v1/markets":"List markets with outcomes and prices (filters: category, search, limit=25).","GET /v1/categories":"Topic categories (Bitcoin, Elections, Sports…)."},"categories":20,"description":"Live prices from Futuur, a global prediction market where users trade on real-world events across crypto, politics, sports, science and economics in real money (USDC) and play money. Each market holds outcomes whose price (0-1) is the market-implied probability. The markets endpoint lists markets, filterable by category and search; the market endpoint returns a single market with every outcome's real-money and play-money price and implied probability, plus category, status and close date; the categories endpoint lists topics. Live, no key, nothing stored. The global prediction-market / event-probability cut — distinct from the US-politics-only and crypto-only prediction markets and the price and FX APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T16:46:38.652Z","request_id":"ffced400-6f13-482b-840b-b51a1edd7356"},"status":"ok","message":"Meta","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":22000,"rps_limit":3,"hard_limit":true},{"slug":"analyst","name":"Analyst","price_cents_month":715,"monthly_call_quota":245000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2160,"monthly_call_quota":960000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5130,"monthly_call_quota":3250000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/futuur-api"}