Get Orders
Search and paginate the account order history using market, status, side, time, and tag filters.
Endpoint
GET /v1/orders
Mainnet: GET https://api.orderly.org/v1/orders
Testnet: GET https://testnet-api.orderly.org/v1/orders
Rate limit: 10 requests per second. Retrieves regular orders with optional filters. The API key must include the trading scope. This signed GET request has no body.
Status shortcuts: INCOMPLETE includes NEW and PARTIAL_FILLED orders; COMPLETED includes CANCELLED and FILLED orders.
Authentication headers
orderly-timestamp — signed-request timestamp in milliseconds.
orderly-account-id — PangoPerps account ID.
orderly-key — public API key.
orderly-signature — request signature.
Query parameters
All query parameters are optional unless indicated otherwise by the service:
symbol
string
Restrict results to one market.
side
string
Filter by BUY or SELL.
order_type
string
Filter by LIMIT or MARKET.
status
string
Filter by NEW, CANCELLED, PARTIAL_FILLED, FILLED, REJECTED, INCOMPLETE, or COMPLETED.
order_tag
string
Match the full stored tag, up to 128 characters; for a current custom-fee tag use enum:pangoperps:<enum_id>.
start_t
number
Start of the time range, as a 13-digit millisecond timestamp.
end_t
number
End of the time range, as a 13-digit millisecond timestamp.
page
number
Page number; starts at 1.
size
number
Number of results per page; maximum 500.
sort_by
string
Sort order: CREATED_TIME_DESC, CREATED_TIME_ASC, or UPDATED_TIME_DESC. When omitted, results are ordered newest-first; ties are ordered by order ID.
Example request
The sort_by parameter accepts CREATED_TIME_DESC, CREATED_TIME_ASC, UPDATED_TIME_DESC, or UPDATED_TIME_ASC. Without it, results sort by updated_time descending when update_start_t or update_end_t is supplied; otherwise they sort by created_time descending. In either case, ties are ordered by order_id descending.
Successful response
HTTP 200 returns pagination metadata and a rows array. Each row provides order identity, market and side, type, price/size/amount, status, fill totals and average price, fees, realized PnL, visibility, reduce-only state, tag, margin mode, and created/updated times.
Last updated