Skip to main content
GET
Get historical orders

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

account_id
string<uuid>

Trading account ID

environment
enum<string>
required

Required broker environment. Includes disabled and deleted accounts. A named account must belong to this environment.

Available options:
paper,
live
symbol
string

Filter orders by symbol. Symbols are normalized to uppercase

external_order_id
string

External broker order ID

intent_id
string<uuid>

Originating intent ID

order_status
string

Comma separated, case-insensitive order statuses. Matches any listed status; unknown values return 400.

order_state
string

Comma separated states: OPEN, CLOSED or REJECTED. Combined with order_status using AND. Unknown values return 400.

start
string<date-time>

Inclusive received_at lower bound. Defaults to 90 days before an explicit end, otherwise 30 days ago. Raised to the plan history window

end
string<date-time>

Exclusive received_at upper bound; defaults to now

limit
integer<int32>

Maximum results; defaults to 100 and is capped at 1000

Required range: x >= 0
sort_by
enum<string>

Sort field; defaults to received_at

Available options:
received_at,
symbol,
quantity,
filled_quantity,
limit_price,
average_price
sort_direction
enum<string>

Sort direction. Defaults to Desc. Lowercase asc/desc are also accepted.

Available options:
Asc,
Desc
next_cursor
string

Opaque keyset pagination cursor from a previous response

Response

Orders retrieved

data
object[]
required
next_cursor
string | null