What you can do
- Browse events and markets — list open prediction markets, filter by category or tag, and retrieve price history.
- Place limit orders — submit bids and asks on event outcomes in both play money and real money modes.
- Manage wagers — retrieve active and settled wager positions for any account.
- Read the order book — access the full depth of bids and asks for any market.
Base URL
All API requests go to:Key resources
| Resource | Description |
|---|---|
| Events | Prediction market events. Each event has one or more outcomes. |
| Markets | The tradeable instrument for a specific outcome within an event. |
| Orders | Limit orders placed on a market outcome (bid or ask, long or short). |
| Wagers | Confirmed positions resulting from matched orders. |
Play money vs. real money
The API supports two currency modes:- Play money (OOM) — use
currency_mode=play_moneyto test your integration without financial risk. - Real money (USDC, USDT, USD) — live trading mode. Requires a funded account.
Start with play money to verify your authentication and order logic before switching to real money mode.
Authentication
Every request requires HMAC-SHA512 authentication using a public/private key pair. See the Authentication page for the full signing process.For AI agents
The full OpenAPI schema is available athttps://api.futuur.com/docs/schema/. Use this to explore all available endpoints, parameters, and response shapes.
Next steps
Authentication
Generate HMAC signatures and authenticate your first request.
Events and markets
Understand how events, outcomes, and markets are structured.
Placing a bet
Follow a step-by-step guide to placing your first order.
List events
Browse the full reference for the events endpoint.