Query Parameters
The wallet address to query positions for.
Filter positions by chain ID (e.g. evm:42161). If omitted, returns positions from all supported chains.
Filter positions by DEX. Supported values: gains, lighter. If omitted, returns positions from all supported DEXes.
Response
Array of open perpetual positions.Show PerpsPosition Object
Unique position identifier
Contract address associated with the position
DEX name. Possible values: gains, hyperliquid, gte, lighter
Position side: BUY (Long) or SELL (Short)
Position size in raw token units (bigint as string). Decimals are the token’s on-chain decimals, except for Lighter which always uses 18 decimals.
Current effective leverage
Estimated liquidation price
Unrealized Profit/Loss in USD
Realized Profit/Loss in USD
Realized Profit/Loss as percentage
Unrealized Profit/Loss as percentage
Funding fees paid/received in USD
Address of collateral token
Array of take-profit orders. Each object contains: size (bigint), price (number), id (number)
Array of stop-loss orders. Each object contains: size (bigint), price (number), id (number)
Date when the position was opened (ISO 8601 format)
Date of last position update (ISO 8601 format)
