# List positions

**GET /trading/accounts/{account_id}/positions**




## Servers
- Production: https://api.example.com/v1 (Production)
- Sandbox: https://sandbox.api.example.com/v1 (Sandbox)


## Authentication methods
- Api key auth


## Parameters
### Headers

- **PRE-ACCESS-KEY** (string)
  Broker access key identifier.

- **PRE-ACCESS-SIGNATURE** (string)
  Keyed BLAKE2b-256 signature (hex lowercase, 64 characters).

- **PRE-ACCESS-TIMESTAMP** (string(date-time))
  RFC3339 timestamp with milliseconds (e.g., 2025-10-30T06:00:34.075Z). Must be within clock_skew_tolerance (default 5m) of server time.


### Path parameters

- **account_id** (string)
  Broker-supplied account identifier; length 1..128; charset [A-Za-z0-9._~-].


### Query parameters

- **market_id** (string)

- **event_id** (string)

- **status** (string)
  Filter by position status. OPEN (default) returns only non-zero qty; ALL returns settled/closed positions as well.

- **presentation** (string)
  Presentation mode for positions.
  - `dual`: returns separate yes_qty and no_qty.
  - `net`: returns a single net quantity (yes_qty - no_qty).

- **cursor** (string)

- **limit** (integer)



## Responses
### 200
Position list

#### Body: application/json (object)
- **items** (array[object])

- **next_cursor** (string | null)


### 400
Validation / semantic error

#### Body: application/json (object)
- **error_code** (string)

- **message** (string)

- **details** (object)


### 503
Backpressure / temporary unavailability

#### Body: application/json (object)
- **error_code** (string)

- **message** (string)

- **details** (object)



[Powered by Bump.sh](https://bump.sh)