---
title: "Get Orders"
method: GET
path: "/v2/orders"
tags: ["orders"]
---

# Get Orders

`GET /v2/orders`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v2/orders`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v2/orders/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of orders placed by a trading account with specified filters.
- Only the last 24 hours of data is available for querying

This endpoint requires [authentication](/rest/authentication#generate-a-jwt-token) and supports [pagination](/rest/general/pagination).
To filter by `createdAtDatetime` and `createdAtTimestamp`, additional parameters are required. For detailed instructions, see the [Filtering Support](/rest/general/filtering) section.
Additionally, this endpoint is subjected to rate limiting.

## Query parameters

- `symbol` string: market symbol. E.g. `BTCUSDC`
- `clientOrderId` string: Unique numeric (i64) identifier generated on the client side expressed as a string value
- `side` 'BUY' | 'SELL'
- `status` 'OPEN' | 'CLOSED' | 'CANCELLED' | 'REJECTED'
- `tradingAccountId` string, required: unique trading account ID
- `isAuctionOrder` boolean

## Response `200`

OK

- Order[]
  - `clientOrderId` string, required: Unique numeric (i64) identifier generated on the client side expressed as a string value
  - `orderId` string, required
  - `symbol` string, required: market symbol. E.g. `BTCUSDC`
  - `price` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `averageFillPrice` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `stopPrice` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `allowBorrow` boolean, required: indicates if the order was allowed to borrow (does not indicate that borrowing occurred)
  - `quantity` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `quantityFilled` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `quoteAmount` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `baseFee` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `quoteFee` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `borrowedBaseQuantity` string: see [asset value](/rest/general/price-quantity-precision) format
  - `borrowedQuoteQuantity` string: see [asset value](/rest/general/price-quantity-precision) format
  - `isLiquidation` boolean, required: indicates if the order was executed as a liquidation order
  - `side` string, required: order side can have the following string values `"BUY"`, `"SELL"`
  - `type` string, required: order type can have the following string values `"LMT"`, `"MKT"`, `"STOP_LIMIT"`, `"POST_ONLY"`. `"MKT"` and `"STOP_LIMIT"` are not applicable for Options
  - `timeInForce` string, required: time in force can have the following string values `"GTC"`, `"FOK"`, `"IOC"`, `"GTX"` (Good Till Crossing - for auction orders), see [details](/rest/general/order-type)
  - `status` string, required: order status can have the following string values `"OPEN"`, `"CLOSED"`, `"CANCELLED"`, `"REJECTED"`
  - `statusReason` string, required: status reason, describes why the order is in a specific state
  - `statusReasonCode` string, required: status reason code, see [details](/rest/general/error-rejection-codes)
  - `createdAtDatetime` string, date-time, required: ISO 8601 with millisecond as string
  - `createdAtTimestamp` string, string, required: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string

## Other responses

- `401`: Not Authenticated
- `403`: Access Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)