Skip to main content
GET
Python (SDK)

Compared to v1 account orders

Account Orders (GET /v2/accounts/{id}/orders) returns legacy field names (orderType, status, quantity, …) and an availability object. This v2 endpoint returns domains/order.Order objects (field names type, ordStatus, qty, …) and paginates with nextCursor instead of bundling availability metadata.

Response envelope

Every 200 response includes orders (array, never null — may be empty) and nextCursor (int64, 0 when there are no more pages). Each order always includes clOrdId, accountId, symbol, quantity/price fields (qty, price, stopPrice, cumQty, leavesQty, avgPrice), and createdAt / updatedAt. Fields such as side, type, ordStatus, and legs may be omitted when unset.

Demo response (v2 shape)

Numeric quantities and prices are returned as decimal strings to preserve precision. The shape is consistent whether the data was served from cache or the database.

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

id
string
required

Account ID whose active orders you want to read. Use the account identifier from the user's account list or trading setup.

Query Parameters

limit
integer
default:50

Maximum number of orders to return in this page. Use smaller values for UI lists and larger values for back-office exports. Default is 50; maximum is 500.

Required range: 1 <= x <= 500
cursor
integer<int64>
default:0

Opaque pagination cursor. Send 0 (or omit) for the first page; pass the previous response's nextCursor for subsequent pages. Stop when nextCursor is absent.

Response

Page of active orders

Paginated v2 orders response from GET /v2/accounts/{id}/orders and GET /v2/accounts/{id}/orders/history. orders is always present; nextCursor is present only when another page exists.

orders
object[] | null
required

Page of orders in v2 domain shape (TradeOrderV2). null from GET /v2/accounts/{id}/orders when the account has no active orders; an empty array from the history endpoint when there are no matches.

nextCursor
integer<int64>

Opaque pagination cursor. Pass as cursor on the next request. This field is omitted on the final page.