Retrieve event

Retrieve full details for a single event, including all its markets (outcomes), resolution criteria, and current prices.

Endpoint

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

Authentication

This endpoint requires HMAC authentication. Include the Key, Timestamp, and HMAC headers on every request. See the authentication guide for signing instructions.

Request

integer

required

The unique identifier of the event to retrieve.

Response

Returns the full event object with all associated markets.

integer

required

Unique identifier for the event.

string

required

The prediction question.

string

required

URL-friendly identifier.

string

required

Current state: open, stopped, resolved, cancelled, paused, or reversed.

object[]

required

Array of market (outcome) objects for this event.

string

Full question details and resolution criteria.

string

ISO 8601 datetime when betting closes.

string

ISO 8601 datetime when the event was resolved.

Example

curl "https://api.futuur.com/v2.0/events/12345/" \
  -H "Key: YOUR_PUBLIC_KEY" \
  -H "Timestamp: 1712500000" \
  -H "HMAC: YOUR_HMAC_SIGNATURE"

import requests

response = requests.get(
    "https://api.futuur.com/v2.0/events/12345/",
    headers={
        "Key": "YOUR_PUBLIC_KEY",
        "Timestamp": "1712500000",
        "HMAC": "YOUR_HMAC_SIGNATURE",
    },
)

event = response.json()
print(f"Event: {event['title']}")
for market in event["markets"]:
    print(f"  Market {market['id']}: {market['name']}")

Sample response (200 OK)

{
  "id": 12345,
  "title": "Who will win the 2024 US Presidential Election?",
  "slug": "2024-us-presidential-election",
  "status": "open",
  "description": "This market resolves based on...",
  "bet_end_date": "2024-11-05T00:00:00Z",
  "markets": [
    {
      "id": 67890,
      "name": "Candidate A",
      "price": 0.55
    },
    {
      "id": 67891,
      "name": "Candidate B",
      "price": 0.42
    }
  ]
}

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Request

Response

Example

​Endpoint

​Authentication

​Request

​Response

​Example

Endpoint

Authentication

Request

Response

Example