> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/order-management/get-algo-order-by-client-order-id.md).

# Get Algo Order by Client Order ID

Retrieve one algorithmic order by the client-assigned ID used when it was created.

### Endpoint

**GET /v1/algo/client/order/{client\_order\_id}**

Mainnet: `GET https://api.orderly.org/v1/algo/client/order/{client_order_id}`

Testnet: `GET https://testnet-api.orderly.org/v1/algo/client/order/{client_order_id}`

Rate limit: 10 requests per second. Returns a single algorithmic order associated with the supplied client order ID. This signed GET request has no body.

### Authentication headers

* orderly-timestamp — signed-request timestamp in milliseconds.
* orderly-account-id — PangoPerps account ID.
* orderly-key — public API key.
* orderly-signature — request signature.

### Path parameter

| Parameter         | Type   | Required | Description                                  |
| ----------------- | ------ | -------- | -------------------------------------------- |
| client\_order\_id | string | Yes      | Client-assigned ID of the algorithmic order. |

### Example request

```bash
curl --request GET \
  --url 'https://api.orderly.org/v1/algo/client/order/pango-algo-001' \
  --header 'orderly-account-id: <account-id>' \
  --header 'orderly-key: <public-api-key>' \
  --header 'orderly-signature: <signature>' \
  --header 'orderly-timestamp: <timestamp-in-ms>'
```

### Successful response

The 200 response uses the algo-order object described in Get Algo Order by Order ID, including its trigger, execution, status, margin, and nested-child details.

```json
{
  "success": true,
  "data": {
    "algo_order_id": 123456789,
    "client_order_id": "pango-algo-001",
    "algo_status": "NEW",
    "algo_type": "STOP",
    "is_triggered": "false",
    "quantity": 0.25,
    "side": "BUY",
    "symbol": "PERP_ETH_USDC",
    "trigger_price": 3400,
    "trigger_price_type": "MARK_PRICE",
    "type": "MARKET",
    "child_orders": []
  },
  "timestamp": 1702989203989
}
```
