---
title: "Get order by ID"
method: GET
path: "/trading/orders/{orderId}"
tags: ["Trading"]
---

# Get order by ID

`GET /trading/orders/{orderId}`

Permissions required: **Read trade activity** or **Execute trades** (if order created by this API key)

Get order by ID, where the ID can be anchorage generated orderId or clientOrderId

## Path parameters

- `orderId` string, required

## Response `200`

Metadata about a specific trade

- OrderStatusResponse
  - `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'.

## 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)