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

tradeHistoryIdstringRequired

Trade history ID

Example: trade-123

positionIdstringRequired

Associated position ID

Example: pos-123

addressstringRequired

User wallet address

Example: 0x1234...abcd

externalFeePaidnumberRequired

Total fee paid to DEX Engine

Example: 0.015

builderFeePaidnumberRequired

Total fee paid to builder

Example: 0.0075

realizedPnlnumberRequired

Total realized PnL value

Example: 0.15

realizedPnlPercentagenumberRequired

Total realized PnL percentage

Example: 0.15

totalValuenumberRequired

Total trade value in USD

Example: 20000

totalEntryValuenumberRequired

Total entry value in USD (sum of size * entry price per asset)

Example: 20000

entryRationumberRequired

Entry ratio for the trade

Example: 0.5

exitRationumberRequired

Exit ratio for the trade

Example: 0.5

positionLongAssetsstring[]Optional

List of long token symbols from position at time of trade

positionShortAssetsstring[]Optional

List of short token symbols from position at time of trade

createdAtstringRequired

Trade timestamp

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

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"
  }
]