---
title: "List participant positions"
method: GET
path: "/positions/participant/{id}"
tags: ["Positions"]
---

# List participant positions

`GET /positions/participant/{id}`

Retrieve all positions for the specified participant maintained at zerohash.

## Path parameters

- `id` string, required

## Query parameters

- `platform_code` string
- `account_label` string

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully retrieved positions for the requested participant.

- GetPositionsResponse
  - `message` PositionsResponseEntity[]
    - `platform_code` string — The code of the platform for the position.
    - `participant_code` string — The code of the participant for the position.
    - `account_label` string — Account label for the account holding the position.
    - `asset` string — The asset code for the position, e.g. `BTC`.
    - `position_all_open_trades` string — The net position of all open trades in the asset, i.e. trades with a `trade_state` of `accepted` or `active`.
    - `position_accepted_trades_only` string — The net position of all trades in the asset with a `trade_state` of `accepted`, i.e. trades where settlement has not yet been attempted.
    - `position_active_trades_only` string — The net position of all trades in the asset with a `trade_state` of `active`, i.e. trades where settlement has been attempted but was unsuccessful.
    - `trade_ids_list` string[] — List of trade IDs contributing to this position (UUIDs from `/trades`).

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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