Retrieve event

Retrieve detailed information about a single event by its ID, including all associated markets and their current prices.

Endpoint

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

Authentication

This endpoint supports HMAC authentication. Include the Key, Timestamp, and HMAC headers to access user-specific data. See the authentication guide for signing instructions.

Request

integer

required

A unique integer value identifying this event.

Response

Returns the full event object with all markets and metadata.

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

required

How markets relate to each other: linked_prices or independent.

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['title']}")

Sample response (200 OK)

{
  "id": 12345,
  "title": "Who will win the 2024 US Presidential Election?",
  "slug": "who-will-win-2024-us-presidential-election",
  "status": "open",
  "markets_correlation": "linked_prices",
  "description": "This market resolves based on...",
  "bet_end_date": "2024-11-05T00:00:00Z",
  "resolve_date": null,
  "markets": [
    {
      "id": 67890,
      "title": "Candidate A",
      "price": 0.55
    },
    {
      "id": 67891,
      "title": "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