---
title: "Get Positions Summary"
method: GET
path: "/executors/positions/summary"
tags: ["Executors"]
---

# Get Positions Summary

`GET /executors/positions/summary`

Get summary of all held positions from executors stopped with keep_position=True.

Returns aggregate information including:
- Total number of active position holds
- Total realized PnL across all positions
- Total unrealized PnL (when market rates are available)
- List of all positions with breakeven prices and PnL

## Response `200`

Successful Response

- PositionsSummaryResponse — Summary of all held positions.
  - `total_positions` integer, required — Number of active position holds
  - `total_realized_pnl` number, required — Total realized PnL across all positions
  - `total_unrealized_pnl` number, nullable — Total unrealized PnL (None if no rates available)
  - `positions` PositionHoldResponse[], required — List of position holds
    - `trading_pair` string, required
    - `connector_name` string, required
    - `account_name` string, required
    - `buy_amount_base` number, required
    - `buy_amount_quote` number, required
    - `sell_amount_base` number, required
    - `sell_amount_quote` number, required
    - `net_amount_base` number, required
    - `buy_breakeven_price` number, nullable, required
    - `sell_breakeven_price` number, nullable, required
    - `matched_amount_base` number, required
    - `unmatched_amount_base` number, required
    - `position_side` string, nullable, required
    - `realized_pnl_quote` number, required
    - `unrealized_pnl_quote` number, nullable
    - `executor_count` integer, required
    - `executor_ids` string[], required
    - `last_updated` string, nullable, required

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/5347fe79537f/schema)