Retrieve event

This endpoint supports optional HMAC authentication. Authenticated requests may return additional user-specific data.

Response

Returns the full event detail object.

integer

required

Unique event identifier.

string

required

The prediction question.

string

required

URL-friendly identifier.

string

required

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

array

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 --request GET \
  --url "https://api.futuur.com/v2.0/events/42/" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712534400" \
  --header "HMAC: YOUR_HMAC_SIGNATURE"

import requests

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

print(response.json())

Sample response

{
  "id": 42,
  "title": "Who will win the 2024 US Presidential Election?",
  "slug": "who-will-win-2024-us-presidential-election",
  "status": "open",
  "description": "This market resolves to the candidate who wins the 2024 US Presidential Election.",
  "bet_end_date": "2024-11-05T00:00:00Z",
  "resolve_date": null,
  "markets": [
    {
      "id": 101,
      "title": "Candidate A",
      "price": 0.52
    },
    {
      "id": 102,
      "title": "Candidate B",
      "price": 0.48
    }
  ]
}

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Request

Response

Example

​Endpoint

​Authentication

​Request

​Response

​Example

Endpoint

Authentication

Request

Response

Example