Skip to main content
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:
HeaderDescription
KeyYour public API key
TimestampCurrent Unix timestamp
HMACSHA-512 signature of the request payload

​
Parameters

​
categories
integer[]
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.
​
hide_my_bets
boolean
default:"false"
When true, excludes events on which you have placed bets.
​
limit
integer
Number of results to return per page.
​
live
boolean
default:"false"
When true, returns only events that are currently live.
​
offset
integer
Number of results to skip for pagination.
​
only_markets_i_follow
boolean
default:"false"
When true, returns only events in markets you follow.
​
ordering
string
Field name to sort results by. Prefix with - for descending order (e.g., -created_at).
​
pending_resolution
boolean
default:"false"
When true, returns only events that are pending resolution.
​
resolved_only
boolean
default:"false"
When true, returns only events that have been resolved.
​
search
string
Full-text search query. Maximum 100 characters.
​
tag
string
Filter results by tag name. Maximum 100 characters.

​
Response

​
count
integer
required
Total number of events matching the query.
​
next
string
URL for the next page of results. null if you are on the last page.
​
previous
string
URL for the previous page of results. null if you are on the first page.
​
results
object[]
required
Array of event objects.

​
Example

cURL
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"
Sample response
{
  "count": 142,
  "next": "https://api.futuur.com/events/?limit=10&offset=10",
  "previous": null,
  "results": [
    {
      "id": 1023,
      "title": "Will the S&P 500 close above 5000 by end of Q2 2026?",
      "description": "This event resolves YES if the S&P 500 index closing price is above 5000 on the last trading day of Q2 2026.",
      "category": 4,
      "currency_mode": "play_money",
      "resolved": false,
      "pending_resolution": false,
      "live": true,
      "tags": ["finance", "stocks"],
      "created_at": "2026-01-10T08:00:00Z",
      "closes_at": "2026-06-30T23:59:59Z"
    }
  ]
}