---
title: "Get user perpetual positions"
method: GET
path: "/api/perpetuals/getPositions"
tags: ["Data Fetching"]
---

# Get user perpetual positions

`GET /api/perpetuals/getPositions`

Retrieves active and pending perpetual positions for a given wallet address.

## Query parameters

- `address` string, required

## Response `200`

List of perpetual positions

- PerpetualInfo[]
  - `position` 'Long' | 'Short'
  - `positionSize` number
  - `leverage` number
  - `stopLoss` number
  - `takeProfit` number
  - `asset` object
    - `ticker` string
    - `asset` Asset
      - `policyId` string, required — The Cardano policy ID of the asset
      - `assetName` string, required — The asset name
    - `type` string
    - `url` string
    - `decimals` integer
    - `dex` string
    - `perpAuthPolicyId` string
  - `collateral` object
    - `amount` number
    - `ticker` string
    - `includeStrike` boolean
    - `strikeAmount` number
  - `entryPrice` number
  - `isPending` boolean
  - `outRef` OutRef
    - `txHash` string, required — Transaction hash
    - `outputIndex` integer, required — Output index in the transaction
  - `status` 'Pending' | 'Completed'
  - `liquidationPrice` number
  - `version` integer
  - `hourlyBorrowFee` number
  - `originalTxHash` string

## Other responses

- `400` — Invalid request
- `500` — Server error

---

[API](https://skmtc.net/strikefinance/apis/strike-finance-staking-api.md) · [All operations](https://skmtc.net/strikefinance/apis/strike-finance-staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/strikefinance/strike-finance-staking-api/revisions/6b7d8bd51050/schema)