Get Positions - Yield.xyz

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

GET

/

v1

/

perps

/

positions

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