---
title: "Get order history"
method: GET
path: "/v1/trader/{authority}/order-history"
tags: ["Trader"]
---

# Get order history

`GET /v1/trader/{authority}/order-history`

Handles `GET /v1/trader/{authority}/order-history` via `get.v1.trader.by_authority.order_history`.

## Path parameters

- `authority` string, required

## Query parameters

- `traderPdaIndex` integer
- `marketSymbol` string
- `limit` integer, required
- `cursor` string
- `privyId` string
- `orderStatus` string

## Response `200`

Order history

- PaginatedResponseVecOrderHistoryItem — Generic paginated response wrapper with bidirectional cursor support. The cursor system supports both forward (newer) and backward (older) pagination: - `prev_cursor`: Use this cursor to poll for new items (items newer than the current result set) - `next_cursor`: Use this cursor to load more items (items older than the current result set) The direction is embedded in the cursor itself, so clients just need to pass the appropriate cursor to the `cursor` parameter.
  - `data` object[], required
    - `baseQty` string, required — Base quantity (human-readable, decimal format)
    - `completedAt` string, date-time, nullable — Timestamp when the order was completed (ISO 8601)
    - `filledBaseQty` string, required — Total filled base quantity (human-readable, decimal format)
    - `isConditionalOrder` boolean — Indicates whether the order originated from a conditional trigger
    - `isReduceOnly` boolean, required — Indicates whether the order was marked reduce-only at placement time
    - `isStopLoss` boolean — Indicates whether the order originated from a stop loss trigger
    - `isStopLossDirection` boolean — Indicates whether the TP/SL trigger used stop-loss direction
    - `marketSymbol` string, required — Market symbol (e.g., "SOL-PERP")
    - `orderSequenceNumber` string, required — Order sequence number
    - `placedAt` string, date-time, nullable — Timestamp when the order was placed (ISO 8601)
    - `price` string, required — Order price (human-readable, decimal format)
    - `remainingBaseQty` string, required — Remaining base quantity (human-readable, decimal format)
    - `side` 'bid' | 'ask', required
    - `status` 'active' | 'cancelled' | 'filled', required
  - `hasMore` boolean, required — Whether there are more results available after this page
  - `nextCursor` string, nullable — Opaque cursor for fetching the next page of older results. Pass this value as the `cursor` parameter in the next request to load more.
  - `prevCursor` string, nullable — Opaque cursor for fetching newer items (for polling). Pass this value as the `cursor` parameter to get items newer than the first item in data.

---

[API](https://skmtc.net/phoenix/apis/phoenix-eternal-api.md) · [All operations](https://skmtc.net/phoenix/apis/phoenix-eternal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phoenix/phoenix-eternal-api/versions/0f598402d680/schema)