---
title: "Get Positions"
method: GET
path: "/v1/positions"
tags: ["Positions"]
---

# Get Positions

`GET /v1/positions`

Retrieve current position information for all trading instruments or a specific symbol.

## Query parameters

- `instType` 'perpetual' | 'spot' | 'btc' | 'digital' | 'stock' | 'index', required
- `symbol` string, required
- `unit` 'sats' | 'btc'

## Response `200`

- ApiResponseForGetPositionsGaywayResponse — Represents a successful API response wrapper
  - `data` GetPositionsGaywayResponse, required
    - `positions` Position[], required
      - `accountId` string, uuid, required
      - `adlRank` integer, required
      - `avgEntry` string, required
      - `avgExit` string, nullable
      - `closeDate` integer, nullable
      - `createdAt` integer, required
      - `entryAmount` string, required
      - `entryFees` string, required
      - `exitAmount` string, required
      - `exitFees` string, nullable
      - `id` string, uuid, required
      - `initialMargin` string, required
      - `instrumentId` string, uuid, required
      - `leverage` string, required
      - `liquidationPrice` string, required
      - `maintenanceMarginRatio` string, required
      - `margin` string, required
      - `openDate` integer, required
      - `side` 'long' | 'short', required
      - `size` string, required
      - `status` 'normal' | 'liq' | 'adl', required
      - `stopLossOrderId` string, uuid, nullable
      - `takeProfitOrderId` string, uuid, nullable
      - `unit` 'sats' | 'btc', required
      - `updatedAt` integer, required
  - `error` boolean, required

---

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