Skip to main content
GET
Get price history
See the integration guide for the workflow and interpretation of this response.

Authorizations

Authorization
string
header
required

Proposed server-to-server API key. No client request HMAC signing scheme is specified.

Headers

X-Client-Request-Id
string

Caller correlation reference; not an idempotency guarantee.

Query Parameters

listing_ids
string[]
required

Rook listing IDs from /markets or /markets:resolve. Select the venue and outcome side explicitly; repeat the query parameter for multiple listings.

Minimum array length: 1

Opaque text identifier. Preserve its exact value.

Minimum string length: 1
start_time
string<date-time>
required

UTC start of the requested observation/execution window. Must precede end_time when both are supplied.

end_time
string<date-time>
required

UTC end of the requested observation/execution window. Must follow start_time when both are supplied.

field
enum<string>
required

Price observation to retrieve: BID, ASK, MIDPOINT or LAST_TRADE, oriented to the selected listing outcome.

Available options:
BID,
ASK,
MIDPOINT,
LAST_TRADE
sampling_interval
string

Supported sampling cadence, such as 1m. The response reports its sampling and carry-forward method; consult coverage for available intervals.

page_size
integer
default:50

Requested maximum items; service caps disclosed by coverage. Oversize requests fail explicitly.

Required range: x >= 1
page_token
string

Opaque continuation; reuse the same filters/order. Cursor pins the original snapshot.

Response

200 - application/json

Success.

items
object[]
required
next_page_token
string | null
required
snapshot_id
string
required

Opaque text identifier. Preserve its exact value.

Minimum string length: 1
as_of
string<date-time>
required