> ## Documentation Index
> Fetch the complete documentation index at: https://yieldxyz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Positions

> Get user's open positions

## Get Positions

Returns all open positions for a user.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.yield.xyz/v1/perps/positions?address=0x..." \
    -H "x-api-key: your_api_key"
  ```
</RequestExample>

## Query Parameters

| Parameter  | Type   | Description           |
| ---------- | ------ | --------------------- |
| `address`  | string | User's wallet address |
| `provider` | string | Filter by provider    |

## Response

```json theme={null}
{
  "positions": [
    {
      "id": "pos_123",
      "market": "BTC-USD-PERP",
      "provider": "hyperliquid",
      "side": "LONG",
      "size": "0.5",
      "entryPrice": "42000",
      "currentPrice": "43000",
      "leverage": 10,
      "unrealizedPnl": "500",
      "liquidationPrice": "38000"
    }
  ]
}
```