Skip to main content
GET
Get historical positions

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 positions by symbol. Symbols are normalized to uppercase

start
string<date-time>

Inclusive received_at lower bound. Defaults to 30 days before an explicit end, otherwise 90 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,
average_cost
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

Positions retrieved

data
object[]
required
next_cursor
string | null