Get price history

GET /api/v1/market-data/prices/history

Get price history

get

Returns historical midpoint price series for a single outcome token. Requires a market address and either token ID or outcome index. Control the lookback window with duration or explicit start_ts/end_ts timestamps. Use fidelity to cap the number of data points returned (downsampled if exceeded).

Query parameters

marketstringRequired

Market contract address

token_idstringOptional

Outcome token ID (provide token_id or outcome_index, not both)

outcome_indexintegerOptional

Outcome index, 0-based (provide token_id or outcome_index, not both)

durationstring · enumOptional

Lookback duration (default 24h)

Possible values:

end_tsintegerOptional

End unix timestamp (default: now)

start_tsintegerOptional

Start unix timestamp (filters results after fetch)

fidelityintegerOptional

Max data points returned — downsamples if the window contains more

Responses

200

OK

application/json

Historical price series.

outcomeNamestringOptional

400

Bad Request

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/api/v1/market-data/prices/history

HTTPcURLJavaScriptPython

GET /api/v1/market-data/prices/history?market=text HTTP/1.1
Host: rest.ft.42.space/
Accept: */*

{
  "history": [
    {
      "p": 1,
      "payout": 1,
      "t": 1,
      "v": 1
    }
  ],
  "outcomeName": "text"
}