Skip to main content
GET
/
v1
/
traders
/
{trader_pubkey}
/
orders_v2
Get order history v2
curl --request GET \
  --url https://perp-api.phoenix.trade/v1/traders/{trader_pubkey}/orders_v2 \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "eventIndex": 123,
      "instructionIndex": 123,
      "instructionType": "<string>",
      "intended": {
        "baseLots": 123,
        "baseQty": "<string>",
        "cancelExisting": true,
        "hasPriceLimit": true,
        "isPostOnly": true,
        "isReduceOnly": true,
        "isStopLoss": true,
        "isTakeOnly": true,
        "orderFlags": 123,
        "orderKind": "<string>",
        "side": "<string>",
        "clientOrderId": "<string>",
        "isConditionalOrder": true,
        "isStopLossDirection": true,
        "lastValidSlot": 123,
        "matchLimit": 123,
        "priceInTicks": 123,
        "priceUsd": "<string>",
        "quoteLotBudget": 123
      },
      "isConditionalOrder": true,
      "isReduceOnly": true,
      "isStopLoss": true,
      "isStopLossDirection": true,
      "marketSymbol": "<string>",
      "orderType": "<string>",
      "price": "<string>",
      "slot": 123,
      "slotIndex": 123,
      "status": "<string>",
      "traderId": 123,
      "traderPdaIndex": 123,
      "traderSubaccountIndex": 123,
      "userId": 123,
      "currentOrderState": {
        "baseQty": "<string>",
        "filledBaseQty": "<string>",
        "orderSequenceNumber": 123,
        "orderStatus": "<string>",
        "price": "<string>",
        "releasedBaseQty": "<string>",
        "remainingBaseQty": "<string>",
        "side": "<string>",
        "cancelledAt": "2023-11-07T05:31:56Z",
        "lastFillAt": "2023-11-07T05:31:56Z",
        "placedAt": "2023-11-07T05:31:56Z"
      },
      "fillBeforePlacement": {
        "numTrades": 123,
        "totalBaseQtyFilled": "<string>",
        "totalNumFills": 123,
        "totalQuoteQtyFilled": "<string>",
        "totalTakerFee": "<string>"
      },
      "placedOrder": {
        "baseQty": "<string>",
        "eventIndex": 123,
        "orderSequenceNumber": 123,
        "price": "<string>",
        "side": "<string>",
        "transactionTimestamp": "2023-11-07T05:31:56Z",
        "initialSlot": 123,
        "lastValidSlot": 123,
        "orderFlags": 123
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "prevCursor": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer access token issued by /v1/auth/* login endpoints.

Path Parameters

​
trader_pubkey
string
required

Query Parameters

​
market_symbol
string

Optional market symbol filter

​
limit
integer<int64>
required

Number of items to return (max 1000)

​
cursor
string

Optional base64-encoded cursor for pagination. Returns items older than (exclusive of) this cursor.

Response

200 - application/json

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
​
hasMore
boolean
required

Whether there are more results available after this page

​
nextCursor
string | null

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 | null

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.