---
title: "GET /orders"
method: GET
path: "/orders"
---

# GET /orders

`GET /orders`

## Query parameters

- `address` string, required
- `subaccountNumber` number, double, required
- `limit` number, double
- `ticker` string
- `side` 'BUY' | 'SELL'
- `type` 'LIMIT' | 'MARKET' | 'STOP_LIMIT' | 'STOP_MARKET' | 'TRAILING_STOP' | 'TAKE_PROFIT' | 'TAKE_PROFIT_MARKET'
- `status` APIOrderStatus[]
  - union
    - 'OPEN' | 'FILLED' | 'CANCELED' | 'BEST_EFFORT_CANCELED' | 'UNTRIGGERED'
    - 'BEST_EFFORT_OPENED'
- `goodTilBlockBeforeOrAt` number, double
- `goodTilBlockAfter` number, double
- `goodTilBlockTimeBeforeOrAt` string
- `goodTilBlockTimeAfter` string
- `returnLatestOrders` boolean

## Response `200`

Ok

- OrderResponseObject[]
  - `id` string, required
  - `subaccountId` string, required
  - `clientId` string, required
  - `clobPairId` string, required
  - `side` 'BUY' | 'SELL', required
  - `size` string, required
  - `totalFilled` string, required
  - `price` string, required
  - `type` 'LIMIT' | 'MARKET' | 'STOP_LIMIT' | 'STOP_MARKET' | 'TRAILING_STOP' | 'TAKE_PROFIT' | 'TAKE_PROFIT_MARKET', required
  - `reduceOnly` boolean, required
  - `orderFlags` string, required
  - `goodTilBlock` string
  - `goodTilBlockTime` string
  - `createdAtHeight` string
  - `clientMetadata` string, required
  - `triggerPrice` string
  - `timeInForce` 'GTT' | 'FOK' | 'IOC', required
  - `status` union, required
    - 'OPEN' | 'FILLED' | 'CANCELED' | 'BEST_EFFORT_CANCELED' | 'UNTRIGGERED'
    - 'BEST_EFFORT_OPENED'
  - `postOnly` boolean, required
  - `ticker` string, required
  - `updatedAt` string
  - `updatedAtHeight` string
  - `subaccountNumber` integer, required

## Changes

- **2025-02-07** `f2f57a53dc45` — 2 info
  - added the new optional `query` request parameter `goodTilBlockAfter`
  - added the new optional `query` request parameter `goodTilBlockTimeAfter`
- **2024-05-21** `ef610e3b14d0` — 3 breaking, 3 info
  - removed the enum value `FAILED_HARD_TRADE` from the `query` request parameter `type`
  - removed the enum value `HARD_TRADE` from the `query` request parameter `type`
  - removed the enum value `TRANSFER_PLACEHOLDER` from the `query` request parameter `type`
  - removed the `FAILED_HARD_TRADE` enum value from the `items/type` response property for the response status `200`
  - …2 more
- **2024-05-14** `90fd32395633` — 4 breaking, 13 warning, 6 info
  - removed the enum value `TWAP` from the `query` request parameter `type`
  - removed the enum value `TWAP_SUBORDER` from the `query` request parameter `type`
  - removed the enum value `ERROR` from the property `items/anyOf[#/components/schemas/OrderStatus]/` of the `query` request parameter `status`
  - the `items/subaccountNumber` response's property type/format changed from `integer`/`int32` to `number`/`double` for status `200`
  - …19 more

[Change history](https://skmtc.dev/dydxprotocol/apis/indexer-api/changes/orders/get.md)

---

[API](https://skmtc.dev/dydxprotocol/apis/indexer-api.md) · [All operations](https://skmtc.dev/dydxprotocol/apis/indexer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dydxprotocol/indexer-api/revisions/983d8a1aa5eb/schema)