---
title: "Get trader market PnL"
method: GET
path: "/v1/traders/{trader_pubkey}/pnl/markets"
tags: ["Trader"]
---

# Get trader market PnL

`GET /v1/traders/{trader_pubkey}/pnl/markets`

Handles `GET /v1/traders/{trader_pubkey}/pnl/markets` via `get.v1.traders.by_trader_pubkey.pnl.markets`.

## Path parameters

- `trader_pubkey` string, required

## Query parameters

- `resolution` string, required
- `startTime` integer
- `endTime` integer
- `limit` integer
- `symbols` string

## Response `200`

- TraderMarketPnLSeries[]
  - `baseDecimals` integer, required — Base decimals used for this market
  - `marketId` integer, required — Market identifier
  - `points` TraderMarketPnLPoint[], required — Time-series points
    - `baseLots` integer, required — Base lots position at the end of the bucket
    - `cumulativeFundingPayment` number, double, required — Cumulative funding payments up to this point
    - `cumulativePnl` number, double, required — Cumulative PnL up to this point
    - `cumulativeTakerFee` number, double, required — Cumulative taker fees paid up to this point
    - `endTime` integer, required — End time in seconds since Unix epoch
    - `markPrice` integer, required — Mark price in ticks at the end of the bucket
    - `realizedPnl` number, double, required — Realized PnL accrued inside the bucket
    - `startTime` integer, required — Start time in seconds since Unix epoch
    - `timestamp` integer, required — Deprecated: Unix timestamp in seconds.
    - `totalTakerFee` number, double, required — Taker fees paid inside the bucket
    - `unrealizedPnl` number, double, required — Unrealized PnL at the end of the bucket
    - `virtualQuoteLots` integer, required — Virtual quote lots position at the end of the bucket
  - `symbol` string, required — Market symbol (e.g. BTC, SOL, ETH)
  - `tickSize` integer, required — Tick size in quote lots per base lot per tick

---

[API](https://skmtc.dev/phoenix/apis/phoenix-eternal-api.md) · [All operations](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/phoenix/phoenix-eternal-api/revisions/0f598402d680/schema)