Skip to main content
Futuur is a prediction market platform where users trade on the outcomes of real-world events. The Futuur API gives you programmatic access to that same platform — letting you build applications that browse markets, place orders, and track positions.

​
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.
  • Subscribe to realtime updates — receive price, order-book, and account events over Pusher WebSockets.
  • Check balances — fetch per-currency ledger balances for your account.

​
Base URL

All API requests go to:
That is https://api.futuur.com + /v2.0. Include the version in every request path.
For reference, the deprecated v1.0 documentation is available at: https://api.futuur.com/v1.0/docs
For AI agents and automated integrations, access the OpenAPI schema directly at: https://api.futuur.com/docs/schema/. This endpoint provides the complete API specification in JSON format, perfect for code generation, API clients, and AI-powered integrations.

​
User-Agent header

Send a non-empty User-Agent header that identifies your client, for example MyApp/1.0 or the default value sent by your HTTP library (python-requests/2.32.0). This applies to public reads as well as authenticated calls. A browser-like value is not required. Scripts and servers, including clients running on cloud hosts, can call /v2.0/, /v1.5/, and /api/.
User-Agent is not part of the HMAC signature. Send it alongside Key, Timestamp, and HMAC; do not include it in the string you sign.

​
Key resources

​
Play money vs. real money

The API supports two currency modes:
  • Play money (OOM) — use currency_mode=play_money to 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 flow before switching to real money.