Fetch a paginated list of events available on the Futuur prediction market. Use query parameters to filter by category, currency mode, resolution status, tags, and more.
Endpoint GET https://api.futuur.com/events/
Authentication HMAC authentication is required. Include the following headers with every request:
Header Description KeyYour public API key TimestampCurrent Unix timestamp HMACSHA-512 signature of the request payload
Parameters Filter results to one or more category IDs. Pass the parameter multiple times to specify multiple categories.
currency_mode
string
default: "play_money"
Restrict results to a specific currency mode. Accepted values: play_money, real_money.
When true, excludes events on which you have placed bets.
Number of results to return per page.
When true, returns only events that are currently live.
Number of results to skip for pagination.
When true, returns only events in markets you follow.
Field name to sort results by. Prefix with - for descending order (e.g., -volume_play_money).
When true, returns only events that are pending resolution.
When true, returns only events that have been resolved.
Full-text search query. Maximum 100 characters.
Filter results by tag name. Maximum 100 characters.
Response Pagination metadata for the result set. Total number of events matching the query.
URL for the next page of results. null if you are on the last page.
URL for the previous page of results. null if you are on the first page.
Number of results returned per page.
Current pagination offset.
Array of event objects (EventList). Unique identifier for the event.
Display title of the event.
URL-friendly identifier for the event.
Current event status: open, stopped, resolved, cancelled, paused, or reversed.
How markets resolve within the event: exclusive (only one market can resolve to long) or non_exclusive (multiple markets can resolve to long).
ISO 8601 timestamp when betting closes. null if not set.
ISO 8601 timestamp when the event was resolved. null if unresolved.
Tags associated with the event. Each tag has name and slug.
Categories the event belongs to. Each category has id, title, and slug.
Outcome markets for this event. Each market includes id, title, price, and status.
Total play money volume traded on this event.
Total real money volume traded on this event.
Whether this event uses the order book for trading.
Example curl --request GET \ --url "https://api.futuur.com/events/?currency_mode=play_money&limit=10&offset=0" \ --header "Key: YOUR_PUBLIC_KEY" \ --header "Timestamp: 1712500000" \ --header "HMAC: YOUR_HMAC_SIGNATURE"
{ "pagination" : { "total" : 142 , "next" : "https://api.futuur.com/events/?limit=10&offset=10" , "previous" : null , "page_size" : 10 , "offset" : 0 }, "results" : [ { "id" : 1023 , "title" : "Will the S&P 500 close above 5000 by end of Q2 2026?" , "slug" : "sp500-above-5000-q2-2026" , "status" : "open" , "resolution_mode" : "exclusive" , "bet_end_date" : "2026-06-30T23:59:59Z" , "resolve_date" : null , "tags" : [ { "name" : "finance" , "slug" : "finance" }, { "name" : "stocks" , "slug" : "stocks" } ], "category" : [ { "id" : 4 , "title" : "Finance" , "slug" : "finance" , "parent" : null } ], "markets" : [ { "id" : 501 , "title" : "Yes" , "price" : 0.62 , "status" : "active" }, { "id" : 502 , "title" : "No" , "price" : 0.38 , "status" : "active" } ], "volume_play_money" : "125000.00" , "volume_real_money" : "42000.00" , "order_book_enabled" : true } ] }
