Skip to main content
GET
/
prices-history
Get price history for a traded token
curl --request GET \
  --url https://clob.forka.st/prices-history
{
  "history": [
    {
      "t": 1697875200,
      "p": "1800.75"
    }
  ]
}
Retrieve historical midpoint prices for a specific token or condition. The endpoint returns evenly spaced samples based on the granularity you supply.

​
Response shape

  • history — array of { "t": number, "p": string } points.
    • t is the Unix timestamp (UTC seconds) for the bucket.
    • p is the midpoint price at that instant, returned as a fixed-precision string to avoid floating-point drift.
Use the string-formatted prices directly in UI components or parse them with arbitrary-precision math libraries when additional calculations are required.

Query Parameters

​
market
string
required

The CLOB token ID for which to fetch price history.

​
startTs
integer<int64>

The start time, as a Unix timestamp in UTC.

​
endTs
integer<int64>

The end time, as a Unix timestamp in UTC.

​
interval
enum<string>

A duration string ending at the current time (mutually exclusive with startTs/endTs).

Available options:
1m,
1w,
1d,
6h,
1h,
max
​
fidelity
integer

The resolution of the data, in minutes.

Required range: x >= 1

Response

200 - application/json

Successful response

​
history
object[]
required