Skip to main content
GET
Get order history (keyset-paginated)

Headers

authorization
string

Bearer <token>: the trader's own session, a partner session token from POST /trade/partner/session, or a personal API key session token from POST /trade/api-keys/session

x-partner-app-id
string

Partner access: your partner app id

x-partner-app-secret
string

Partner access: your partner app secret (server-side only)

x-trader-api-key
string

Partner access: the trader's API key (hpk_...). Personal access: your personal API key (hpp_...), sent without the partner app headers

x-trader-email
string

Optional: the trader's sign-in email; must match the key's owner

x-partner-firm
string

Optional: organization id, slug or name; limits results to the trader's accounts at that firm

Query Parameters

accountId
string

Restrict to one trading account

contract
string

Restrict to one contract (full symbol)

status
enum<string>

Filter by order status (omit for all). partially_filled orders are still working with part of their quantity executed.

Available options:
filled,
partially_filled,
cancelled,
rejected
limit
integer
default:100

Most rows per page. A trader with many accounts may get fewer rows per page; keep following nextCursor.

Required range: 1 <= x <= 1000
cursor
string

Opaque cursor from the previous page's nextCursor

Response

Order history page

success
boolean
Example:

true

data
object