---
title: "GET /perpetualPositions"
method: GET
path: "/perpetualPositions"
---

# GET /perpetualPositions

`GET /perpetualPositions`

## Query parameters

- `address` string, required
- `subaccountNumber` number, double, required
- `status` PerpetualPositionStatus[]
- `limit` number, double
- `createdBeforeOrAtHeight` number, double
- `createdBeforeOrAt` string

## Response `200`

Ok

- PerpetualPositionResponse
  - `positions` PerpetualPositionResponseObject[], required
    - `market` string, required
    - `status` 'OPEN' | 'CLOSED' | 'LIQUIDATED', required
    - `side` 'LONG' | 'SHORT', required
    - `size` string, required
    - `maxSize` string, required
    - `entryPrice` string, required
    - `realizedPnl` string, required
    - `createdAt` string, required
    - `createdAtHeight` string, required
    - `sumOpen` string, required
    - `sumClose` string, required
    - `netFunding` string, required
    - `unrealizedPnl` string, required
    - `closedAt` string
    - `exitPrice` string, nullable
    - `subaccountNumber` integer, required

---

[API](https://skmtc.net/dydxprotocol/apis/indexer-api.md) · [All operations](https://skmtc.net/dydxprotocol/apis/indexer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dydxprotocol/indexer-api/versions/5005547cef75/schema)