---
title: "List orders"
method: GET
path: "/trading/orders"
tags: ["Trading"]
---

# List orders

`GET /trading/orders`

Permissions required: **Execute trades** or **Read trade activity**

List all orders. With the permission **Read trade activity** all orders of the organization may be read. With the permission **Execute trades** only the orders created by this API key may be read.

Orders are sorted in a descending order by their timestamp, i.e. the most recent order or the order with a timestamp closest to `endDate` is listed first.

When filtering by `subaccountId`, the allocation information is included but filtered to show only the allocation for the requested subaccount.
For multi-order requests without a subaccount filter, allocation information is not included.
To get complete allocation information, use [GET `/v2/trading/orders/{orderId}`](#tag/Trading/operation/getOrderStatus)

#### Filters

You may optionally supply filters for the list of orders using query parameters below

## Query parameters

- `accountId` string
- `subaccountId` string
- `startDateTime` string, date-time
- `endDateTime` string, date-time
- `status` string[]
- `orderIds` string[]
- `clientOrderIds` string[]
- `limit` integer
- `orderTypes` string[]

## Response `200`

A list of Orders and their last status

- OrdersStatusResponse
  - `data` TradingOrderDetails[], required
    - `accountId` string, required — Account ID for this order to book into.
    - `allocation` Allocation[] — Subaccount allocation
      - `counterQtyAllIn` string, required — Counter quantity all in
      - `counterQtyAllInToSettle` string, required — Counter quantity all in to be settled
      - `cumQty` string, required — Filled quantity
      - `executionId` string — Execution identifier
      - `fee` string, required — Fee
      - `quantity` string, required — Allocated quantity
      - `subaccountId` string, required — The Subaccount Identifier
    - `avgPx` string, required — Average filled price for this order.
    - `avgPxAllIn` string, required — Average filled price + anchorage commission.
    - `cancelQty` string — quantity canceled for this order.
    - `clOrderId` string, required — Original client order ID as submitted.
    - `counterQty` string — Filled quantity of the counter currency.
    - `counterQtyAllIn` string — Filled quantity of the counter currency including all fees.
    - `cumQty` string, required — Cumulative filled quantity for this order. For open orders, orderQty = leavesQty + cumQty. For canceled order, leavesQty = 0, orderQty = cancelQty + cumQty.
    - `currency` string, required — The currency in which order quantity is specified in.
    - `feeCurrency` string, required — Currency commission was charged in, which is always the opposite currency from what the order quantity is specified in.
    - `leavesQty` string, required — quantity that is still open for this order.
    - `limitPrice` string — Original limit price for this order if present.
    - `orderId` string, required — Order ID generated by anchorage.
    - `orderQty` string, required — Original order quantity.
    - `orderStatus` 'PENDING' | 'NEW' | 'PARTIALLY_FILLED' | 'FILLED' | 'REJECTED' | 'PENDING_CANCEL' | 'CANCELED', required — Order status
    - `orderType` 'MARKET' | 'LIMIT' | 'STOP_LIMIT' | 'TAKE_PROFIT_LIMIT' | 'STOP_LOSS' | 'TWAP' | 'VWAP' | 'PEGGED' | 'POV' | 'RFQ' | 'LIMIT_ALL_IN' | 'MANUAL' | 'OTHER', required — General order type.
    - `reasonText` string — Additional description for reason of reject or cancel.
    - `rejectReason` string — Reason for rejection.
    - `side` 'BUY' | 'SELL', required — Order side, either "BUY" or "SELL".
    - `strategyParams` object — Strategy Parameters
      - `data` StrategyParams
        - `endTime` string, date-time — The expire time for the order. An ISO-8601 UTC string of the form 2019-02-13T05:17:32.000000Z.
        - `triggerPrice` string — The price that must be met to trigger execution of the order with the configured limit price.
    - `subaccountId` string — Subaccount ID for this order to book into.
    - `subaccountTransactionId` string — Subaccount transaction ID linked with this order.
    - `submitTime` string, date-time — UTC timestamp when order is submitted. [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) 'date-time'.
    - `symbol` string, required — Symbol for the order, e.g. BTC-USD.
    - `timeInForce` 'GTC' | 'FOK' | 'IOC' — Time in force defines the order expiry
    - `totalFee` string, required — Commission charged for this order.
    - `transactTime` string, date-time, required — UTC timestamp when order is executed. [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) 'date-time'.
  - `page` Page, required — Pagination info
    - `next` string, nullable — URL to use to query for the next page or null if no additional results are available

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)