Price history - Futuur API

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

integer

required

The unique identifier of the event.

currency_mode

string

required

The currency mode to query. Accepted values: play_money, real_money.

time_interval

string

The time range for the price history. Accepted values: day, week, month, year, all_time. Defaults to all available history if omitted.

Response

history

object[]

required

Array of price data points ordered chronologically.

Show properties

timestamp

string

ISO 8601 timestamp for this data point.

outcomes

object[]

Price snapshot for each outcome at this timestamp.

Show properties

outcome_id

integer

Unique identifier of the outcome.

name

string

Display name of the outcome.

price

number

Implied probability price of the outcome at this timestamp (0–1).

currency_mode

string

The currency mode for the returned history: play_money or real_money.

time_interval

string

The time interval applied to this response.

Example

cURL

curl --request GET \
  --url "https://api.futuur.com/events/1023/price_history/?currency_mode=play_money&time_interval=week"

Sample response

{
  "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 }
      ]
    }
  ]
}

​Endpoint

​Authentication

​Parameters

​Response

​Example

Endpoint

Authentication

Parameters

Response

Example