---
title: "Get algo order by id"
method: GET
path: "/algo/orders/{algo_id}"
tags: ["Algos"]
---

# Get algo order by id

`GET /algo/orders/{algo_id}`

## Request

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

Get an algo order by id. Only return algo order in `OPEN` or `NEW` status.

## Path parameters

- `algo_id` string, required

## Response `200`

OK

- ResponsesAlgoOrderResp
  - `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

- `404`: Not Found

## 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 `404`
  - added the new `ADDRESS_BOOK_REPEATED_IN_IMPORT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `404`
  - added the new `STARKNET_PARENT_ONBOARDING_DISABLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `404`
- **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 `404`
  - added the new `SESSION_REVOKED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `404`
- …earlier changes not shown

[Operation history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/algo/orders/:algo_id/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)