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

# Get algo orders history

`GET /algo/orders-history`

## Request

- Base URL: `https://api.prod.paradex.trade/v1`
- URL: `https://api.prod.paradex.trade/v1/algo/orders-history`
- Auth: API key in header `Authorization`

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_params` object: Type-specific algo parameters
    - `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

## Changes

- **2026-10-22** `f33feb7333ea`: 3 warning
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `ADDRESS_BOOK_REPEATED_IN_IMPORT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `STARKNET_PARENT_ONBOARDING_DISABLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- **2026-10-20** `72c125c93c2b`: 2 warning
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `SESSION_REVOKED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- …earlier changes not shown

[Operation history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/algo/orders-history/get.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) - [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/revisions/f33feb7333ea?raw)