Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.futuur.com/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve the full details of a specific event, including its markets, resolution status, and metadata. To find events related to this one, call GET /events/{id}/related_events/ — it returns a list of similar events based on topic and category, with no authentication required.

​
Endpoint

GET https://api.futuur.com/events/{id}/

​
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

​
id
integer
required
The unique identifier of the event to retrieve.

​
Response

​
id
integer
required
Unique identifier for the event.
​
title
string
required
Display title of the event.
​
description
string
Full description of the event and its resolution criteria.
​
category
integer
ID of the category this event belongs to.
​
currency_mode
string
Currency mode for this event: play_money or real_money.
​
resolved
boolean
Whether the event has been resolved.
​
resolution
string
Resolution outcome, if resolved. null for unresolved events.
​
pending_resolution
boolean
Whether the event is awaiting resolution.
​
live
boolean
Whether the event is currently live.
​
tags
string[]
List of tags associated with the event.
​
markets
object[]
The markets associated with this event.
​
created_at
string
ISO 8601 timestamp of when the event was created.
​
closes_at
string
ISO 8601 timestamp of when the event closes for new bets.
​
resolved_at
string
ISO 8601 timestamp of when the event was resolved. null if unresolved.

​
Example

cURL
curl --request GET \
  --url "https://api.futuur.com/events/1023/" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712500000" \
  --header "HMAC: YOUR_HMAC_SIGNATURE"
Sample response
{
  "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,
  "resolution": null,
  "pending_resolution": false,
  "live": true,
  "tags": ["finance", "stocks"],
  "markets": [
    {
      "id": 501,
      "question": "Will the S&P 500 close above 5000?",
      "outcomes": [
        { "id": 1, "name": "Yes", "price": 0.62 },
        { "id": 2, "name": "No", "price": 0.38 }
      ]
    }
  ],
  "created_at": "2026-01-10T08:00:00Z",
  "closes_at": "2026-06-30T23:59:59Z",
  "resolved_at": null
}