Skip to main content
GET
/
prices-history
Get historical midpoint prices
curl --request GET \
  --url https://clob.kuest.com/prices-history
{
  "history": [
    {
      "t": 123,
      "p": "<string>"
    }
  ]
}
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

Token identifier (market) to query.

​
startTs
integer<int64>

Start of the time range (unix timestamp in seconds). Required when interval is absent.

​
endTs
integer<int64>

End of the time range (unix timestamp in seconds). Defaults to now when omitted.

​
interval
enum<string>

Preset time window to query. Cannot be used with startTs/endTs.

Available options:
1m,
5m,
15m,
1h,
6h,
1d,
1w,
max
​
fidelity
integer<int32>

Bucket size in minutes when using explicit timestamps. Auto-calculated when omitted.

Required range: x >= 1

Response

Time series of midpoint prices

​
history
object[]
required