---
title: "Get one scoped position history row with its fills"
method: GET
path: "/v1/positions/history-details"
tags: ["positions"]
---

# Get one scoped position history row with its fills

`GET /v1/positions/history-details`

## Query parameters

- `walletAddress` string
- `copyProfileId` string, uuid
- `openedAfter` string, date-time
- `openedBefore` string, date-time
- `positionId` string, uuid, required

## Response `200`

Successful response

- PositionHistoryDetailsOutput
  - `position` PositionHistoryItem, required
    - `id` string, required
    - `symbol` string, required
    - `side` 'LONG' | 'SHORT', required
    - `size` number, required
    - `entry_price` number, required
    - `closed_price` number, nullable, required
    - `leverage_type` string, required
    - `leverage_value` integer, required
    - `realized_pnl` number, required
    - `close_reason` 'MANUAL' | 'TAKE_PROFIT' | 'STOP_LOSS' | 'TRAILING_STOP' | 'LIQUIDATION' | 'AUTO_DELEVERAGE', nullable, required
    - `opened_at` string, required
    - `closed_at` string, nullable, required
    - `total_fees` number, required
    - `total_funding` number, required
    - `fills` HistoryFill[], required
      - `fill_id` string, required
      - `symbol` string, required
      - `side` string, required
      - `direction` string, nullable, required
      - `size` number, required
      - `price` number, required
      - `fee` number, required
      - `closed_pnl` number, required
      - `executed_at` string, required
    - `fillsLoaded` boolean, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Resource not found
- `500` — Internal server error

## Changes

- **2026-09-26** `09f21ccc6e03` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/legend/apis/legend-api/changes/v1/positions/history-details/get.md)

---

[API](https://skmtc.dev/legend/apis/legend-api.md) · [All operations](https://skmtc.dev/legend/apis/legend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/legend/apis/legend-api/revisions/cc5ceda89fac?raw)