Skip to main content
This guide walks you through finding an event, checking the current price, and placing an order — from an immediate order that takes the best prices to a limit order that rests on the book.
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 GET /v2.0/events/ to browse available prediction markets. You can search by keyword or filter by category. This endpoint does not require authentication.
The response includes a results array of events. Each event has an id and a markets array containing individual outcomes you can bet on.
Set currency_mode=play_money while testing. Switch to real_money when you’re ready to trade with USDC, USDT, or USD.
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 price between 0.01 and 0.99 and leave time_in_force at its default (gtc). The order fills when someone trades against it.
If the best ask is above 0.45, your order rests on the book until someone sells at that price. The response shows status: "processing" first; the order becomes open once matching has run. See Order lifecycle.

Next steps