Skip to main content
GET
List trades
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>

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

end_time
string<date-time>

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

order
enum<string>

Execution-time ordering: ASC for chronological replay or DESC for most recent first. Keep unchanged during pagination.

Available options:
ASC,
DESC
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