---
title: "Query Historical Algo Orders"
method: GET
path: "/sapi/v1/algo/spot/historicalOrders"
tags: ["Spot Algo"]
---

# Query Historical Algo Orders

`GET /sapi/v1/algo/spot/historicalOrders`

## Request

- Base URL: `https://api.binance.com`
- URL: `https://api.binance.com/sapi/v1/algo/spot/historicalOrders`
- Auth: API key in header `X-MBX-APIKEY`

Get all historical SPOT TWAP orders

Weight(IP): 1

## Query parameters

- `symbol` string, required
- `side` 'SELL' | 'BUY', required
- `startTime` integer
- `endTime` integer
- `page` integer
- `pageSize` string
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

twap historical orders

- object
  - `total` integer, required
  - `orders` object[], required
    - `algoId` integer, required
    - `symbol` string, required
    - `side` string, required
    - `totalQty` string, required
    - `executedQty` string, required
    - `executedAmt` string, required
    - `avgPrice` string, required
    - `clientAlgoId` string, required
    - `bookTime` integer, required
    - `endTime` integer, required
    - `algoStatus` string, required
    - `algoType` string, required
    - `urgency` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized Request

## Changes

- **2023-09-28** `1c55b3bb10d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/algo/spot/historicalOrders/get.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) - [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/binance/apis/binance-public-spot-api/revisions/0dd2f133e12d?raw)