---
title: "Get Position Held"
method: GET
path: "/executors/positions/{connector_name}/{trading_pair}"
tags: ["Executors"]
---

# Get Position Held

`GET /executors/positions/{connector_name}/{trading_pair}`

Get held position for a specific connector/trading pair.

Returns the aggregated position from executors stopped with keep_position=True,
including breakeven prices, matched/unmatched volume, realized PnL, and unrealized PnL.

## Path parameters

- `connector_name` string, required
- `trading_pair` string, required

## Query parameters

- `account_name` string

## Response `200`

Successful Response

- PositionHoldResponse — API response model for PositionHold.
  - `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

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-08** `92703f48a69e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/executors/positions/:connector_name/:trading_pair/get.md)

---

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