Skip to main content
GET

Authorizations

Authorization
string
header
required

A Hyperprop session token, the partner session token returned by POST /trade/partner/session, or the personal API key session token returned by POST /trade/api-keys/session.

Query Parameters

account_id
string<uuid> | null

Filter by trading account ID

contract
string | null

Filter by contract (full symbol like ESH6, NQH6)

product
string | null

Filter by product (CME, CBOT, NYMEX, COMEX)

symbol
string | null

Filter by symbol (ES, NQ, YM, RTY, CL, GC, etc.)

side
string | null

Filter by order side (buy, sell)

order_type
string | null

Filter by order type (market, limit, stop)

status
string | null

Filter by order status (e.g. pending_submit, new, working, pending, filled, cancelled, rejected)

from
string | null

Start date (inclusive, ISO 8601 format)

to
string | null

End date (inclusive, ISO 8601 format)

before
string | null

Keyset cursor: pass the previous page's next_before to get the next page. Events that share a timestamp at a page boundary are never skipped. A bare processed_at timestamp still works (returns events older than it).

limit
integer<int32> | null

Maximum number of results (default: 100, max: 1000; larger values are lowered to 1000 and the response sets limit_capped: true)

offset
integer<int32> | null

Number of results to skip for pagination (default: 0)

Response

Paginated append-only order lifecycle events

Paginated order history response

success
boolean
required
code
string | null
data
object | null
error
string | null