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

# Price history

> Retrieve the historical price data for an event over a specified time interval.

Fetch time-series price history for an event. Use this endpoint to plot price charts or analyze how market sentiment has changed over time. This endpoint does not require authentication.

## Endpoint

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

## Authentication

No authentication is required for this endpoint.

## Parameters

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

<ParamField query="currency_mode" type="string" required>
  The currency mode to query. Accepted values: `play_money`, `real_money`.
</ParamField>

<ParamField query="time_interval" type="string">
  The time range for the price history. Accepted values: `day`, `week`, `month`, `year`, `all_time`. Defaults to all available history if omitted.
</ParamField>

## Response

<ResponseField name="history" type="object[]" required>
  Array of price data points ordered chronologically.

  <Expandable title="properties">
    <ResponseField name="timestamp" type="string">
      ISO 8601 timestamp for this data point.
    </ResponseField>

    <ResponseField name="outcomes" type="object[]">
      Price snapshot for each outcome at this timestamp.

      <Expandable title="properties">
        <ResponseField name="outcome_id" type="integer">
          Unique identifier of the outcome.
        </ResponseField>

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

        <ResponseField name="price" type="number">
          Implied probability price of the outcome at this timestamp (0–1).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="currency_mode" type="string">
  The currency mode for the returned history: `play_money` or `real_money`.
</ResponseField>

<ResponseField name="time_interval" type="string">
  The time interval applied to this response.
</ResponseField>

## Example

```bash cURL theme={null}
curl --request GET \
  --url "https://api.futuur.com/events/1023/price_history/?currency_mode=play_money&time_interval=week"
```

```json Sample response theme={null}
{
  "currency_mode": "play_money",
  "time_interval": "week",
  "history": [
    {
      "timestamp": "2026-03-29T00:00:00Z",
      "outcomes": [
        { "outcome_id": 1, "name": "Yes", "price": 0.58 },
        { "outcome_id": 2, "name": "No", "price": 0.42 }
      ]
    },
    {
      "timestamp": "2026-03-30T00:00:00Z",
      "outcomes": [
        { "outcome_id": 1, "name": "Yes", "price": 0.60 },
        { "outcome_id": 2, "name": "No", "price": 0.40 }
      ]
    },
    {
      "timestamp": "2026-04-05T00:00:00Z",
      "outcomes": [
        { "outcome_id": 1, "name": "Yes", "price": 0.62 },
        { "outcome_id": 2, "name": "No", "price": 0.38 }
      ]
    }
  ]
}
```