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.

Authentication

Learn how to generate HMAC signatures and authenticate requests.

Core Concepts

Understand events, markets, orders, and wagers.

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 your account settings.
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.