Skip to main content
GET
/
trader
/
{authority}
/
trades-history
Get trade history
curl --request GET \
  --url https://perp-api.phoenix.trade/trader/{authority}/trades-history
{
  "data": [
    {
      "baseLotsAfter": "<string>",
      "baseLotsBefore": "<string>",
      "baseLotsDelta": "<string>",
      "eventIndex": 123,
      "fees": "<string>",
      "instructionIndex": 123,
      "instructionType": "<string>",
      "liquidity": "maker",
      "marketSymbol": "<string>",
      "price": "<string>",
      "realizedPnl": "<string>",
      "slot": 123,
      "slotIndex": 123,
      "subaccountIndex": 123,
      "timestamp": "2023-11-07T05:31:56Z",
      "tradeType": "limit",
      "traderId": 123,
      "traderPdaIndex": 123,
      "userId": 123,
      "virtualQuoteLotsAfter": "<string>",
      "virtualQuoteLotsBefore": "<string>",
      "virtualQuoteLotsDelta": "<string>",
      "fillId": "<string>",
      "orderSequenceNumber": 123,
      "signature": "<string>",
      "splineSequenceNumber": 123
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "prevCursor": "<string>"
}

Path Parameters

​
authority
string
required

Authority pubkey

Query Parameters

​
pdaIndex
integer<int32>
Required range: x >= 0
​
marketSymbol
string
​
limit
integer<int64>
​
cursor
string

Response

200 - application/json

Trade history

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.