---
title: "Orders History"
method: POST
path: "/auth/r/orders/hist"
---

# Orders History

`POST /auth/r/orders/hist`

## Request

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

Retrieves all user's closed/cancelled orders up to 2 weeks in the past.

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