---
title: "GET /orders"
method: GET
path: "/orders"
tags: ["order-gateway"]
---

# GET /orders

`GET /orders`

Returns historical orders for the authenticated user, newest first by default, paged via the response cursor. The time range is optional and unbounded; an inverted range (`end_timestamp_ns` <= `start_timestamp_ns`) is rejected with a 400. Optionally narrow the result to specific orders via `order_id` and/or `order_ids`. Pages may be returned partial.

## Query parameters

- `symbol` string, nullable
- `timeseries` F6d12211013f441f968471751c829deb, required — unresolved $ref
- `order_states` OrderState[], nullable
- `order_id` string, nullable
- `order_ids` string[], nullable
- `account_id` string, nullable

## Response `200`

List of orders

- GetOrdersResponse — Page metadata for cursor-paged responses. This is intended for response bodies (not query params).
  - `limit` integer, nullable
  - `next_cursor` string, nullable
  - `total_count` integer, nullable
  - `orders` OrderDetails[], required
    - `tn` integer, required
    - `ts` integer, required
    - `aid` string, required — Owning account — whose positions, balance, and risk this order moves.
    - `cid` integer
    - `d` 'B' | 'S', required
    - `o` 'PENDING' | 'ACCEPTED' | 'PARTIALLY_FILLED' | 'FILLED' | 'CANCELED' | 'REJECTED' | 'EXPIRED' | 'REPLACED' | 'DONE_FOR_DAY' | 'UNKNOWN', required
    - `oid` string, required — Strong type for Order IDs to prevent mixing with other string values Order IDs are ULIDs with a prefix: - Regular orders: O-<ULID> - Liquidation orders: L-<ULID>
    - `p` string, required
    - `po` boolean
    - `q` integer, required
    - `r` 'CLOSE_ONLY' | 'INSUFFICIENT_MARGIN' | 'MAX_OPEN_ORDERS_EXCEEDED' | 'UNKNOWN_SYMBOL' | 'EXCHANGE_CLOSED' | 'INCORRECT_QUANTITY' | 'INVALID_PRICE_INCREMENT' | 'INCORRECT_ORDER_TYPE' | 'PRICE_OUT_OF_BOUNDS' | 'NO_LIQUIDITY' | 'INSUFFICIENT_CREDIT_LIMIT' | 'ORIGINAL_ORDER_TERMINATED' | 'DUPLICATE_CLIENT_ORDER_ID' | 'UNKNOWN'
    - `rq` integer, required
    - `s` string, required
    - `tag` string, nullable
    - `tif` string, required
    - `txt` string, nullable
    - `u` string, required — Actor of record — the authenticated user who *placed* this order. This is distinct from the owning `account_id`: a user may place orders on an account they do not own (e.g. a proxy or algo acting for another party).
    - `xq` integer, required

## Other responses

- `400` — Invalid historical order query

---

[API](https://skmtc.net/architect/apis/ax-api-gateway.md) · [All operations](https://skmtc.net/architect/apis/ax-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/architect/ax-api-gateway/revisions/2955c31c524d/schema)