Skip to main content

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.

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

​
id
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.
​
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 }
      ]
    }
  ]
}