> ## 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 event

> Fetch detailed information for a single prediction market event by its unique ID.

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

* For related events, call [`GET /events/{id}/related_events/`](/api-reference/events/related-events) — no authentication required.
* For event tax rates, call [`GET /events/{id}/get_tax/`](/api-reference/events/get-tax) — no authentication required.

## Endpoint

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

## Authentication

HMAC authentication is required. Include the following headers with every request:

| Header      | Description                              |
| ----------- | ---------------------------------------- |
| `Key`       | Your public API key                      |
| `Timestamp` | Current Unix timestamp                   |
| `HMAC`      | SHA-512 signature of the request payload |

## Parameters

<ParamField path="id" type="integer" required>
  The unique identifier of the event to retrieve.
</ParamField>

## Response

Returns an `EventDetail` object.

<ResponseField name="id" type="integer" required>
  Unique identifier for the event.
</ResponseField>

<ResponseField name="title" type="string" required>
  Display title of the event.
</ResponseField>

<ResponseField name="slug" type="string" required>
  URL-friendly identifier for the event.
</ResponseField>

<ResponseField name="description" type="string">
  Full description of the event and its resolution criteria.
</ResponseField>

<ResponseField name="status" type="string" required>
  Current event status: `open`, `stopped`, `resolved`, `cancelled`, `paused`, or `reversed`.
</ResponseField>

<ResponseField name="resolution_mode" type="string">
  How markets resolve within the event: `exclusive` or `non_exclusive`.
</ResponseField>

<ResponseField name="resolution" type="integer">
  ID of the winning market, if resolved. `null` for unresolved events.
</ResponseField>

<ResponseField name="bet_end_date" type="string">
  ISO 8601 timestamp when betting closes. `null` if not set.
</ResponseField>

<ResponseField name="resolve_date" type="string">
  ISO 8601 timestamp when the event was resolved. `null` if unresolved.
</ResponseField>

<ResponseField name="event_start_date" type="string">
  ISO 8601 timestamp when the underlying event starts. `null` if not applicable.
</ResponseField>

<ResponseField name="event_end_date" type="string">
  ISO 8601 timestamp when the underlying event ends. `null` if not applicable.
</ResponseField>

<ResponseField name="tags" type="object[]" required>
  Tags associated with the event. Each tag has `name` and `slug`.
</ResponseField>

<ResponseField name="category" type="object[]" required>
  Categories the event belongs to. Each category has `id`, `title`, and `slug`.
</ResponseField>

<ResponseField name="available_currencies" type="string[]">
  Currencies accepted for this event (for example, `OOM`, `USDC`, `USDT`, `USD`).
</ResponseField>

<ResponseField name="canonical_currency" type="string">
  Real-money bets on this event are converted to this currency.
</ResponseField>

<ResponseField name="order_book_enabled" type="boolean">
  Whether this event uses the order book for trading.
</ResponseField>

<ResponseField name="markets" type="object[]" required>
  Outcome markets for this event.

  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      Unique identifier for the market.
    </ResponseField>

    <ResponseField name="title" type="string">
      Display name of the market outcome.
    </ResponseField>

    <ResponseField name="price" type="number">
      Current implied probability price (0–1).
    </ResponseField>

    <ResponseField name="status" type="string">
      Market status: `active`, `resolved`, `paused`, `stopped`, `cancelled`, or `reversed`.
    </ResponseField>

    <ResponseField name="position_labels" type="string">
      Label style for long/short positions: `yesno`, `updown`, or `custom`.
    </ResponseField>

    <ResponseField name="long_label" type="string">
      Custom label for long positions, if set.
    </ResponseField>

    <ResponseField name="short_label" type="string">
      Custom label for short positions, if set.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="volume_play_money" type="string" required>
  Total play money volume traded on this event.
</ResponseField>

<ResponseField name="volume_real_money" type="string" required>
  Total real money volume traded on this event.
</ResponseField>

## Example

```bash cURL theme={null}
curl --request GET \
  --url "https://api.futuur.com/events/1023/" \
  --header "Key: YOUR_PUBLIC_KEY" \
  --header "Timestamp: 1712500000" \
  --header "HMAC: YOUR_HMAC_SIGNATURE"
```

```json Sample response theme={null}
{
  "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"
}
```