---
title: "Get algo orders history"
method: GET
path: "/algo/orders-history"
tags: ["Algos"]
---

# Get algo orders history

`GET /algo/orders-history`

Get current user algo orders filtered on attributes

## Query parameters

- `client_id` string
- `cursor` string
- `end_at` integer
- `market` string
- `page_size` integer
- `side` 'BUY' | 'SELL'
- `start_at` integer
- `status` 'OPEN' | 'CLOSED' | 'NEW'
- `type` 'LIMIT' | 'MARKET' | 'STOP_LIMIT' | 'STOP_MARKET' | 'STOP_LOSS_LIMIT' | 'STOP_LOSS_MARKET' | 'TAKE_PROFIT_LIMIT' | 'TAKE_PROFIT_MARKET'

## Response `200`

OK

- object
  - `next` string — The pointer to fetch next set of records (null if there are no records left)
  - `prev` string — The pointer to fetch previous set of records (null if there are no records left)
  - `results` object[] — Array of paginated results
    - `account` string — Account identifier (user's account address)
    - `algo_type` '' | 'TWAP'
    - `avg_fill_price` string — Average fill price of the order
    - `cancel_reason` string — Reason for algo cancellation if it was closed by cancel
    - `created_at` integer — Algo creation time
    - `end_at` integer — Algo end time
    - `id` string — Unique algo identifier
    - `last_updated_at` integer — Algo last update time. No changes once status=CLOSED
    - `market` string — Market to which algo belongs
    - `remaining_size` string — Remaining size of the algo
    - `side` 'BUY' | 'SELL'
    - `size` string — Algo size
    - `status` 'NEW' | 'UNTRIGGERED' | 'OPEN' | 'CLOSED'

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tradeparadex/apis/paradex-rest-api.md) · [All operations](https://skmtc.net/tradeparadex/apis/paradex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api/versions/26dce0f96ab2/schema)