Current Positions

Query Current Positions

Query user's current position list.

HTTP Request

GET

/api/perp-trade-api/curr-info/positions

Request Frequency Restriction:

• Recommended: no more than 10 times per second

Authentication Required:

• JWT Token required
• X-Wallet-Address header required

Request Headers

Name	Type	Required	Description
Authorization	string	Yes	JWT Token, format: Bearer {token}
X-Wallet-Address	string	Yes	Wallet address

Request Parameters

Name	Type	Required	Description
symbol	string	No	Trading pair, e.g., ETH-PERP, if not provided, query all trading pairs

Response Fields Description

Returns position array, each position contains:

Name	Type	Description
id	long	Position ID
userAddress	string	User address
symbol	string	Trading pair
avgEntryPrice	string	Average entry price
margin	string	Margin
leverage	string	Leverage
quantity	string	Quantity
createdAt	long	Creation time (milliseconds)
updatedAt	long	Update time (milliseconds)
positionSelectedLeverage	string	Selected leverage
marginType	string	Margin type
oraclePrice	string	Oracle price
midMarketPrice	string	Mid market price
liquidationPrice	string	Liquidation price
side	string	Direction (LONG/SHORT)
positionValue	string	Position value
unrealizedProfit	string	Unrealized profit/loss
roe	string	Unrealized profit/loss percentage
fundingDue	string	Unsettled funding fee
fundingFeeNext	string	Expected next funding fee
settlementFundingFee	string	Settled funding fee for this position
netMargin	string	Net margin
isDeliste	integer	Whether delisted
positionQtyReducible	string	Reducible position quantity
tpPrice	string	Take profit price
slPrice	string	Stop loss price
tpslNum	integer	Total number of take profit/stop loss orders

Response Example

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 123,
      "userAddress": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
      "symbol": "ETH-PERP",
      "avgEntryPrice": "2500",
      "margin": "500",
      "leverage": "5",
      "quantity": "1",
      "createdAt": 1700000000000,
      "updatedAt": 1700000000000,
      "positionSelectedLeverage": "5",
      "marginType": "ISOLATED",
      "oraclePrice": "2505",
      "midMarketPrice": "2505",
      "liquidationPrice": "2000",
      "side": "LONG",
      "positionValue": "2505",
      "unrealizedProfit": "5",
      "roe": "0.01",
      "fundingDue": "0.1",
      "fundingFeeNext": "0.0001",
      "settlementFundingFee": "0.5",
      "netMargin": "505",
      "isDeliste": 0,
      "positionQtyReducible": "1",
      "tpPrice": "2600",
      "slPrice": "2400",
      "tpslNum": 2
    }
  ]
}