Skip to main content
Retrieve the full details of a specific event, including its markets, resolution status, and metadata.

​
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

Returns an EventDetail object.
​
id
integer
required
Unique identifier for the event.
​
title
string
required
Display title of the event.
​
slug
string
required
URL-friendly identifier for the event.
​
description
string
Full description of the event and its resolution criteria.
​
status
string
required
Current event status: open, stopped, resolved, cancelled, paused, or reversed.
​
resolution_mode
string
How markets resolve within the event: exclusive or non_exclusive.
​
resolution
integer
ID of the winning market, if resolved. null for unresolved events.
​
bet_end_date
string
ISO 8601 timestamp when betting closes. null if not set.
​
resolve_date
string
ISO 8601 timestamp when the event was resolved. null if unresolved.
​
event_start_date
string
ISO 8601 timestamp when the underlying event starts. null if not applicable.
​
event_end_date
string
ISO 8601 timestamp when the underlying event ends. null if not applicable.
​
tags
object[]
required
Tags associated with the event. Each tag has name and slug.
​
category
object[]
required
Categories the event belongs to. Each category has id, title, and slug.
​
available_currencies
string[]
Currencies accepted for this event (for example, OOM, USDC, USDT, USD).
​
canonical_currency
string
Real-money bets on this event are converted to this currency.
​
order_book_enabled
boolean
Whether this event uses the order book for trading.
​
markets
object[]
required
Outcome markets for this event.
​
volume_play_money
string
required
Total play money volume traded on this event.
​
volume_real_money
string
required
Total real money volume traded on this event.

​
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?",
  "slug": "sp500-above-5000-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.",
  "status": "open",
  "resolution_mode": "exclusive",
  "resolution": null,
  "bet_end_date": "2026-06-30T23:59:59Z",
  "resolve_date": null,
  "event_start_date": "2026-04-01T00:00:00Z",
  "event_end_date": "2026-06-30T23:59:59Z",
  "tags": [
    { "name": "finance", "slug": "finance" },
    { "name": "stocks", "slug": "stocks" }
  ],
  "category": [
    { "id": 4, "title": "Finance", "slug": "finance", "parent": null }
  ],
  "available_currencies": ["OOM", "USDC"],
  "canonical_currency": "USDC",
  "order_book_enabled": true,
  "markets": [
    {
      "id": 501,
      "title": "Yes",
      "price": 0.62,
      "status": "active",
      "position_labels": "yesno",
      "long_label": "Yes",
      "short_label": "No"
    },
    {
      "id": 502,
      "title": "No",
      "price": 0.38,
      "status": "active",
      "position_labels": "yesno",
      "long_label": "Yes",
      "short_label": "No"
    }
  ],
  "volume_play_money": "125000.00",
  "volume_real_money": "42000.00"
}