Skip to main content
Welcome to the Futuur API. Use this API to integrate prediction markets into your applications: browse live events, place limit orders on market outcomes, track wagers, and retrieve price history.

Quick Start

Get up and running with your first API call in minutes.

Get your API keys

Create HMAC keys in Settings, or derive them from your wallet.

Authentication

Learn how to generate HMAC signatures and authenticate requests.

Core Concepts

Understand events, markets, orders, and wagers.

On-chain trading

Coming soon: CLOB matching with on-chain settlement.

API Reference

Explore every endpoint with request and response details.

How it works

1

Get your API keys

Sign up at futuur.com and generate your public and private API keys from SettingsAPI keys. See Get your API keys.
2

Authenticate requests

Sign each request using HMAC-SHA512 with your private key. Pass your public key, a timestamp, and the signature as headers.
3

Browse events

Call GET /events/ to list available prediction markets. Filter by category, tag, currency mode, or search term.
4

Place an order

Call POST /orders/ to place a limit or market order on any open event outcome. Choose a side (bid/ask) and position (long/short).
The Futuur API supports both play money (OOM) and real money (USDC, USDT, USD) modes. Use currency_mode=play_money to test your integration without financial risk.
On-chain CLOB trading is coming soon. Today’s production API still uses HMAC-only ledger settlement. See On-chain trading to prepare.