---
url: /api/reference/list-positions.md
description: >-
  List currently-open positions across all your accounts, with optional
  single-account filter.
---

# GET /positions

Returns your currently-open positions across all accounts. Pass `?account_id=` to scope to one account.

Each position includes:

* `signal` — `SignalSummary` sub-object (`{ signal_id, telegram_message_id } | null`) — the originating Telegram message. Use this to correlate live positions to the channel post that triggered the trade without a separate join.
* `unrealized_pl` — live unrealized P\&L.
* `current_price` — the position's current market price.
* `account_id`, `account_label`, `currency` — which account owns this position.

This endpoint is not paginated. It returns all your open positions in one response, with a `truncated` field beside `data`. `truncated` is `false` in normal use; it is `true` only if the read stopped before reaching every open position, in which case the list is incomplete.

***
