All examples use
https://api.futuur.com/v2.0. Authenticated requests require HMAC headers. See Get your API keys and the Authentication guide for how to generate them.On the phase-one preview host, orders in
OOM and USDC also need the signed-intent fields (order_intent_signature, order_intent_expiry, order_intent_nonce, max_usdc_raw). The bodies below show the order fields only. See Place an on-chain order and Environment.1
Find an event
Use The response includes a
GET /v2.0/events/ to browse available prediction markets. You can search by keyword or filter by category. This endpoint does not require authentication.results array of events. Each event has an id and a markets array containing individual outcomes you can bet on.2
Inspect the event's markets
Each event has one or more markets, each representing a possible outcome. Retrieve a single event to see its markets in detail.Note the
id of the market you want to bet on and its current price (implied probability between 0 and 1).3
Place an immediate order
To buy shares right away, send
time_in_force: "ioc" with the highest price you accept. The order fills at that price or better, and any unfilled remainder is canceled.A market order (price: null) cannot be used for OOM or USDC on the phase-one preview host, because the signed intent contains a price.4
Place a limit order
To rest on the book at your own price, send a If the best ask is above 0.45, your order rests on the book until someone sells at that price. The response shows
price between 0.01 and 0.99 and leave time_in_force at its default (gtc). The order fills when someone trades against it.status: "processing" first; the order becomes open once matching has run. See Order lifecycle.Next steps
- Reading the order book — understand market depth before placing orders
- Selling a position — exit or reduce your wager
- Orders reference — full endpoint documentation