For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

Parameter
Type
Description

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