Get Positions

Get user’s open positions

GET /v1/perps/positions

cURL

curl "https://api.yield.xyz/v1/perps/positions?address=0x..." \
  -H "x-api-key: your_api_key"

Get Positions

Returns all open positions for a user.

cURL

curl "https://api.yield.xyz/v1/perps/positions?address=0x..." \
  -H "x-api-key: your_api_key"

Query Parameters

Parameter	Type	Description
address	string	User’s wallet address
provider	string	Filter by provider

Response

{
  "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"
    }
  ]
}