---
title: "A wallet's open/closed positions, plus its open equity vaults (`equityPositions`)"
method: GET
path: "/v1/partner/positions/{address}"
tags: ["Partner"]
---

# A wallet's open/closed positions, plus its open equity vaults (\`equityPositions\`)

`GET /v1/partner/positions/{address}`

## Request

- Base URL: `https://api.spiralstake.xyz`
- URL: `https://api.spiralstake.xyz/v1/partner/positions/{address}`
- Auth: HTTP bearer

## Path parameters

- `address` string, required

## Query parameters

- `chainId` 1 | 4663

## Response `200`

Positions

- object
  - `chainId` integer
  - `userAddress` string
  - `positions` object[]: Plain loop positions; a vault's yield loop(s) are excluded and listed under equityPositions.
  - `equityPositions` object[]

## Other responses

- `400`: Invalid input
- `401`: Missing/invalid API key
- `429`: Rate limited
- `503`: Transient (stale data / no route / RPC) — retry

---

[API](https://skmtc.dev/spiralstake/apis/spiral-stake-read-api-v1.md) · [All operations](https://skmtc.dev/spiralstake/apis/spiral-stake-read-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/spiralstake/apis/spiral-stake-read-api-v1/revisions/e58af20cd747?raw)