---
title: "Get all trade history"
method: GET
path: "/trade-history"
tags: ["Trade History"]
---

# Get all trade history

`GET /trade-history`

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

## Query parameters

- `limit` number
- `startDate` string
- `endDate` string

## Response `200`

Trade history retrieved successfully

- TradeHistoryDataDto[]
  - `tradeHistoryId` string, required — Trade history ID
  - `positionId` string, required — Associated position ID
  - `address` string, required — User wallet address
  - `externalFeePaid` number, required — Total fee paid to DEX Engine
  - `builderFeePaid` number, required — Total fee paid to builder
  - `realizedPnl` number, required — Total realized PnL value
  - `realizedPnlPercentage` number, required — Total realized PnL percentage
  - `totalValue` number, required — Total trade value in USD
  - `totalEntryValue` number, required — Total entry value in USD (sum of size * entry price per asset)
  - `entryRatio` number, required — Entry ratio for the trade
  - `exitRatio` number, required — Exit ratio for the trade
  - `closedLongAssets` TradeHistoryAssetDataDto[], required — Long assets in the trade
    - `coin` string, required — Asset symbol
    - `leverage` number, required — Leverage used for this asset
    - `entryPrice` number, required — Entry price for this asset
    - `entryWeight` number, required — Entry weight for this asset
    - `limitPrice` number, required — Limit price for this asset
    - `size` number, required — Trade size for this asset
    - `externalFeePaid` number, required — Fee paid to DEX Engine
    - `builderFeePaid` number, required — Fee paid to builder
    - `realizedPnl` number, required — Realized PnL percentage for this asset
  - `closedShortAssets` TradeHistoryAssetDataDto[] — Short assets in the trade
    - `coin` string, required — Asset symbol
    - `leverage` number, required — Leverage used for this asset
    - `entryPrice` number, required — Entry price for this asset
    - `entryWeight` number, required — Entry weight for this asset
    - `limitPrice` number, required — Limit price for this asset
    - `size` number, required — Trade size for this asset
    - `externalFeePaid` number, required — Fee paid to DEX Engine
    - `builderFeePaid` number, required — Fee paid to builder
    - `realizedPnl` number, required — Realized PnL percentage for this asset
  - `positionLongAssets` string[] — List of long token symbols from position at time of trade
  - `positionShortAssets` string[] — List of short token symbols from position at time of trade
  - `createdAt` string, required — Trade timestamp

## Other responses

- `404` — No trade history found

---

[API](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api.md) · [All operations](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pearprotocol/pear-protocol-trading-api/revisions/d5e1438dfaa7/schema)