---
title: "Get orders"
url: https://docs.truemarkets.co/api/institutional/get-orders-plural-cefi
description: "Fetches all orders for a client entered within the past 24 hours on the exchange. A filter can be provided to limit the results."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get orders

Fetches all orders for a client entered within the past 24 hours on the exchange. A filter can be provided to limit the results.

## Request

```
GET https://api.truex.co/v1/cefi/orders
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `x-truex-auth-timestamp` | header | string | yes | Timestamp when request was made in seconds since epoch. Must be no older than 15 seconds and no more than 1 second in the future. It guards against replayed requests. |
| `size` | query | integer | no | Number of records to return per page. Maximum allowed value is 100. |
| `skip` | query | integer | no | Number of records to skip before returning results. Used for offset-based pagination. |
| `timestamp` | query | string | yes | A Unix UTC timestamp in nanoseconds used as a reference point for fetching orders. The query will retrieve results created **before** this timestamp, enabling precise time-based filtering and ensuring stable pagination. If omitted, the server responds with **400 BAD REQUEST**. |
| `status` | query | string | no | Comma-separated list of order statuses to filter by. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Successful operation.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `[].client_id` | string | no | A unique identifier assigned to the client. |
| `[].external_id` | string | no | External identifier supplied by the client when the order was created. |
| `[].instrument_id` | string | no | A unique identifier for the trading instrument. |
| `[].order_id` | string | no | A unique identifier for the order. |
| `[].trade_price` | string | no | The price at which the trade was executed. |
| `[].trade_qty` | string | no | The quantity of the asset traded. |
| `[].side` | string, one of `BUY`, `SELL` | no | The side of the order (BUY/SELL). |
| `[].trade_fee_bps` | string | no | The fee rate applied to the trade, in basis points of notional. |
| `[].trade_fee_rate` | string | no | Deprecated: `trade_fee_bps` as a decimal fraction of notional. Returned for one release, then removed. |
| `[].liq_flag` | string, one of `TAKER`, `MAKER`, `SETTER` | no | Indicates whether the trade was executed as a taker or a maker. SETTER is a maker fill whose order set the best bid or offer and still held it when executed (Rulebook 2.14.2); it is charged the maker fee. |
| `[].match_id` | string | no | A unique identifier for the trade match event. |
| `[].timestamp` | string | no | The Unix UTC timestamp (in nanoseconds) when the trade was executed. |

### 400

Bad request.

### 401

Unauthorized.

### 403

Forbidden.

### 408

Request timeout.

### 415

Unsupported media type.

### 500

Internal server error.

### 503

Service unavailable.
