---
title: "List open positions"
url: https://docs.truemarkets.co/api/gateway/list-positions
description: "Returns a read-only list of the authenticated user's open positions. Data is fetched on demand from the venue; nothing is persisted."
---

Docs index: https://docs.truemarkets.co/llms.txt

# List open positions

Returns a read-only list of the authenticated user's open positions. Data is fetched on demand from the venue; nothing is persisted.

## Request

```
GET https://api.truemarkets.co/v1/gateway/positions
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `TM-On-Behalf-Of` | header | string (uuid) | no | Act as one of your organization's users. The value is the `user_id` returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: `400` for a personal token, a repeated header or a non-UUID, `403` for a user outside your organization. Not accepted on organization-scoped routes. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Positions retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `positions` | array of object | yes | Open positions |
| `positions[].asset_id` | string (uuid) | no | Unique asset identifier for the perp; pass as `asset_id` when creating an order. Empty when the coin is not listed. |
| `positions[].venue` | string, one of `defi`, `cefi` | no | The trading venue to filter by. * **defi** — Decentralized exchange (on-chain swaps). * **cefi** — Centralized exchange (off-chain order book). |
| `positions[].symbol` | string | no | Asset ticker symbol (e.g. BTC) |
| `positions[].side` | string, one of `long`, `short` | no | Position direction |
| `positions[].size` | string | no | Absolute position size in the base asset (decimal string) |
| `positions[].entry_price` | string | no | Average entry price (decimal string) |
| `positions[].mark_price` | string | no | Current mark price used to value the position (decimal string) |
| `positions[].liquidation_price` | string, nullable | no | Estimated liquidation price, or null when none is reported |
| `positions[].margin_used` | string | no | Margin committed to this position (decimal string) |
| `positions[].unrealized_pnl` | string | no | Signed unrealized PnL at mark (decimal string). Reported but never added into a portfolio total; balances and margin are already marked to market. |
| `positions[].return_on_equity` | string | no | Unrealized PnL as a fraction of margin used (decimal string) |
| `positions[].leverage` | integer | no | Configured leverage for the position |

### 400

Bad request

### 401

Unauthorized

### 403

Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.

### 500

Internal server error
