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

CLOB matching with on-chain settlement. Phase one runs on the preview host.

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 Settings → API 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 order (gtc or ioc) 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.
Phase one of on-chain trading runs on a preview host on Base Sepolia, where every OOM and USDC order needs a wallet-signed intent. Production (https://api.futuur.com) still uses HMAC-only ledger settlement. See Environment.