---
title: "Orders History (by symbol)"
method: POST
path: "/auth/r/orders/{symbol}/hist"
---

# Orders History (by symbol)

`POST /auth/r/orders/{symbol}/hist`

## Request

- Base URL: `https://api.bitfinex.com/v2`
- URL: `https://api.bitfinex.com/v2/auth/r/orders/{symbol}/hist`
- Auth: none required

Retrieves all user's closed/cancelled orders up to 2 weeks in the past by trading pair symbol (e.g. tBTCUSD, tLTCBTC, ...).

## Path parameters

- `symbol` string, required

## Request body

- object
  - `start` integer: If start is given, only records with MTS_CREATE >= start (milliseconds) will be given as response.
  - `end` integer: If end is given, only records with MTS_CREATE <= end (milliseconds) will be given as response.
  - `limit` integer: Number of records in response (max. 2500)
  - `id` integer[]: Allows users to retrieve specific orders by Order ID (id: [ID1, ID2, ID3]).

## Response `200`

200

---

[API](https://skmtc.dev/bitfinex/apis/api-settings-auth.md) - [All operations](https://skmtc.dev/bitfinex/apis/api-settings-auth/llms.txt) - [OpenAPI document](https://skmtc.dev/bitfinex/apis/api-settings-auth/revisions/f3285778c5f9?raw)