> 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-orders.md).

# Get Orders

Search and paginate the account order history using market, status, side, time, and tag filters.

### Endpoint

**GET /v1/orders**

Mainnet: `GET https://api.orderly.org/v1/orders`

Testnet: `GET https://testnet-api.orderly.org/v1/orders`

Rate limit: 10 requests per second. Retrieves regular orders with optional filters. The API key must include the trading scope. This signed GET request has no body.

Status shortcuts: INCOMPLETE includes NEW and PARTIAL\_FILLED orders; COMPLETED includes CANCELLED and FILLED orders.

### Authentication headers

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

### Query parameters

All query parameters are optional unless indicated otherwise by the service:

| Parameter   | Type   | Description                                                                                                                                                |
| ----------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| symbol      | string | Restrict results to one market.                                                                                                                            |
| side        | string | Filter by BUY or SELL.                                                                                                                                     |
| order\_type | string | Filter by LIMIT or MARKET.                                                                                                                                 |
| status      | string | Filter by NEW, CANCELLED, PARTIAL\_FILLED, FILLED, REJECTED, INCOMPLETE, or COMPLETED.                                                                     |
| order\_tag  | string | Match the full stored tag, up to 128 characters; for a current custom-fee tag use enum:pangoperps:\<enum\_id>.                                             |
| start\_t    | number | Start of the time range, as a 13-digit millisecond timestamp.                                                                                              |
| end\_t      | number | End of the time range, as a 13-digit millisecond timestamp.                                                                                                |
| page        | number | Page number; starts at 1.                                                                                                                                  |
| size        | number | Number of results per page; maximum 500.                                                                                                                   |
| sort\_by    | string | Sort order: CREATED\_TIME\_DESC, CREATED\_TIME\_ASC, or UPDATED\_TIME\_DESC. When omitted, results are ordered newest-first; ties are ordered by order ID. |

### Example request

The sort\_by parameter accepts CREATED\_TIME\_DESC, CREATED\_TIME\_ASC, UPDATED\_TIME\_DESC, or UPDATED\_TIME\_ASC. Without it, results sort by updated\_time descending when update\_start\_t or update\_end\_t is supplied; otherwise they sort by created\_time descending. In either case, ties are ordered by order\_id descending.

```bash
curl --request GET \
  --url 'https://api.orderly.org/v1/orders?symbol=PERP_ETH_USDC&status=INCOMPLETE&page=1&size=100' \
  --header 'orderly-account-id: <account-id>' \
  --header 'orderly-key: <public-api-key>' \
  --header 'orderly-signature: <signature>' \
  --header 'orderly-timestamp: <timestamp-in-ms>'
```

### Successful response

HTTP 200 returns pagination metadata and a rows array. Each row provides order identity, market and side, type, price/size/amount, status, fill totals and average price, fees, realized PnL, visibility, reduce-only state, tag, margin mode, and created/updated times.

```json
{
  "success": true,
  "data": {
    "meta": {
      "total": 1,
      "records_per_page": 100,
      "current_page": 1
    },
    "rows": [
      {
        "order_id": 123456789,
        "user_id": 98765,
        "price": 3450.5,
        "type": "LIMIT",
        "quantity": 0.25,
        "amount": 862.625,
        "total_executed_quantity": 0,
        "visible_quantity": 0.25,
        "symbol": "PERP_ETH_USDC",
        "side": "BUY",
        "status": "NEW",
        "total_fee": 0,
        "fee_asset": "USDC",
        "client_order_id": "pango-demo-001",
        "average_executed_price": 0,
        "created_time": 1702989100000,
        "updated_time": 1702989100000,
        "realized_pnl": 0,
        "executed_quantity": 0,
        "visible": 0.25,
        "executed": 0,
        "reduce_only": false,
        "order_tag": "enum:pangoperps:example",
        "margin_mode": "CROSS"
      }
    ]
  },
  "timestamp": 1702989203989
}
```
