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

​
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 logic before switching to real money mode.

​
Authentication

Every authenticated 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 at https://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.

My balances

Fetch per-currency ledger balances for your account.

Realtime (websockets)

Subscribe to realtime market and account events over Pusher.

​
Support

For questions or issues, contact support@futuur.com.