---
title: "Get Closed PnL"
method: GET
path: "/api/v1/position/closed-pnl"
tags: ["Position"]
---

# Get Closed PnL

`GET /api/v1/position/closed-pnl`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/position/closed-pnl`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/position/closed-pnl/get.ts> (a function with typed inputs; its response is checked against the schema)

Query user's closed profit and loss records

## Query parameters

- `sub_account_address` string, required
- `symbol` string
- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

Closed PnL

- GetClosedPnlResponse: Closed PnL response.
  - `list` ClosedPnl[], required
    - `avg_entry_price` string, required: Average entry price
    - `avg_exit_price` string, required: Average exit price
    - `close_fee` string, required: Close position trading fee
    - `closed_pnl` string, required: Closed PnL
    - `closed_size` string, required
    - `created_time` string, date-time, required
    - `cum_entry_value` string, required: Cumulated Position value
    - `cum_exit_value` string, required: Cumulated exit position value
    - `exec_type` 'Trade' | 'AdlTrade' | 'Funding' | 'BustTrade' | 'Delivery' | 'Settle' | 'BlockTrade' | 'MovePosition' | 'FutureSpread', required: Execution type for trade history entries.
    - `fill_count` string, required: The number of fills in a single order
    - `leverage` string, required: Leverage
    - `open_fee` string, required: Open position trading fee
    - `order_id` string, uuid, required
    - `order_price` string, required
    - `order_type` 'Limit' | 'Market', required: Order type: Limit, Market.
    - `qty` string, required
    - `side` 'Sell' | 'Buy', required: Order side: buy or sell.
    - `sub_account_address` string, required
    - `symbol` string, required
    - `updated_time` string, date-time, required
  - `next_page_cursor` string, required

## Changes

- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/position/closed-pnl/get.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)