Trade History

Get all trade history

get

Retrieve all trade history for the authenticated user with detailed trade information including fees, PnL, and asset-level data

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitnumberOptional

Maximum number of records to return (for pagination/infinite scroll).

Example: 50

startDatestringOptional

Filter trades created on/after this time. Accepts ISO string or ms timestamp.

Example: 2024-01-01T00:00:00.000Z

endDatestringOptional

Filter trades created on/before this time. Accepts ISO string or ms timestamp.

Example: 2024-12-31T23:59:59.999Z

Responses

200

Trade history retrieved successfully

application/json

404

No trade history found

get

/trade-history

HTTPcURLJavaScriptPython

GET /trade-history HTTP/1.1
Host: hl-v2.pearprotocol.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "tradeHistoryId": "trade-123",
    "positionId": "pos-123",
    "address": "0x1234...abcd",
    "externalFeePaid": 0.015,
    "builderFeePaid": 0.0075,
    "realizedPnl": 0.15,
    "realizedPnlPercentage": 0.15,
    "totalValue": 20000,
    "totalEntryValue": 20000,
    "entryRatio": 0.5,
    "exitRatio": 0.5,
    "closedLongAssets": [
      {
        "coin": "BTC",
        "leverage": 2,
        "entryPrice": 50000,
        "entryWeight": 0.5,
        "limitPrice": 52000,
        "size": 0.5,
        "externalFeePaid": 0.01,
        "builderFeePaid": 0.005,
        "realizedPnl": 0.1
      }
    ],
    "closedShortAssets": [
      {
        "coin": "BTC",
        "leverage": 2,
        "entryPrice": 50000,
        "entryWeight": 0.5,
        "limitPrice": 52000,
        "size": 0.5,
        "externalFeePaid": 0.01,
        "builderFeePaid": 0.005,
        "realizedPnl": 0.1
      }
    ],
    "positionLongAssets": [
      "text"
    ],
    "positionShortAssets": [
      "text"
    ],
    "createdAt": "2024-01-01T00:00:00.000Z"
  }
]