# Futuur Prediction Markets API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/futuur-api/..." ``` ## Pricing - **Free** (Free) — 22,000 calls/Mo, 3 req/s - **Analyst** ($7/Mo) — 245,000 calls/Mo, 10 req/s - **Pro** ($22/Mo) — 960,000 calls/Mo, 28 req/s - **Scale** ($51/Mo) — 3,250,000 calls/Mo, 60 req/s ## Endpoints ### Markets #### `GET /v1/markets` — List markets with outcomes and prices **Parameters:** - `search` (query, optional, string) — Search term Example: `bitcoin` - `category` (query, optional, string) — Category id - `limit` (query, optional, string) — Max markets (1-100) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/futuur-api/v1/markets?search=bitcoin&limit=25" ``` **Response:** ```json { "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, …(truncated, see openapi.json for full schema) ``` ### Market #### `GET /v1/market` — A single market with all outcomes and odds **Parameters:** - `id` (query, required, string) — Market id Example: `231754` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/futuur-api/v1/market?id=231754" ``` **Response:** ```json { "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:0 …(truncated, see openapi.json for full schema) ``` ### Categories #### `GET /v1/categories` — Topic categories **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/futuur-api/v1/categories" ``` **Response:** ```json { "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 …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/futuur-api/v1/meta" ``` **Response:** ```json { "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 …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/futuur-api OpenAPI spec: https://www.oanor.com/api/futuur-api/openapi.json