獲取倉位列表

使用該請求，可獲取用戶所有的倉位列表。

   //逐倉
   {
     "id": "500000000000000060",
     "symbol": "XBTUSDM",
     "autoDeposit": false,
     "crossMode": false,
     "maintMarginReq": 0.025,
     "riskLimit": 4,
     "realLeverage": 0.17,
     "delevPercentage": 0.25,
     "openingTimestamp": 1717575656090,
     "currentTimestamp": 1717644848634,
     "currentQty": 1,
     "currentCost": -0.000014802,
     "currentComm": 0.0000016124,
     "unrealisedCost": -0.0000143236,
     "realisedGrossCost": -0.0000004784,
     "realisedCost": 0.000001134,
     "isOpen": true,
     "markPrice": 71497.49,
     "markValue": -0.0000139865,
     "posCost": -0.0000143236,
     "posCross": 0.0000671432,
     "posCrossMargin": 0.0000666266,
     "posInit": 0.0000143236,
     "posComm": 0.0000000637,
     "posCommCommon": 0.0000000571,
     "posLoss": 0,
     "posFunding": 0,
     "posMargin": 0.0000815305,
     "posMaint": 0.0000004232,
     "maintMargin": 0.0000818676,
     "realisedGrossPnl": 0.0000004784,
     "realisedPnl": 0.000002006,
     "unrealisedPnl": 0.0000003371,
     "unrealisedPnlPcnt": 0.0235,
     "unrealisedRoePcnt": 0.0235,
     "avgEntryPrice": 69814.85,
     "liquidationPrice": 10478.79,
     "bankruptPrice": 10439.46,
     "settleCurrency": "XBT",
     "isInverse": true,
     "maintainMargin": 0.025,
     "marginMode": "ISOLATED", // 新增字段
     "positionSide": "BOTH", // 新增字段
     "leverage": 0.17 // 新增字段（同realLeverage）
   }
   
   
   //全倉
   {
   	"id": "500000000000000037",
   	"symbol": "XBTUSDTM",
   	"crossMode": true,
   	"delevPercentage": 0.18,
   	"openingTimestamp": 1717071888225,
   	"currentTimestamp": 1717645230645,
   	"currentQty": -11503,
   	"currentCost": -777297.064,
   	"currentComm": 502198.83836837,
   	"unrealisedCost": -778591.0762741665,
   	"realisedGrossCost": 1294.0122741665,
   	"realisedCost": 503492.8506425365,
   	"isOpen": true,
   	"markPrice": 71059.32,
   	"markValue": -817395.35796,
   	"posCost": -778591.0762741665,
   	"posInit": 77859.1076274167, // 初始保证金（posCost/leverage）
   	"posMargin": 81739.535796, // 仓位占用保证金 (markValue*imr)
   	"realisedGrossPnl": -1294.0122741665,
   	"realisedPnl": 499536.3226406035,
   	"unrealisedPnl": -38804.2816858335,
   	"unrealisedPnlPcnt": -0.0498,
   	"unrealisedRoePcnt": -0.4984,
   	"avgEntryPrice": 67685.91,
   	"liquidationPrice": 983470.75, // 参考强平价格（全仓强平实际以风险率为准）
   	"bankruptPrice": 989293.44, // 参考破产价格（全仓强平实际以风险率为准）
   	"settleCurrency": "USDT",
   	"isInverse": false,
   	"marginMode": "CROSS", // CROSS-全仓，ISOLATED-逐仓
   	"positionSide": "BOTH",
   	"leverage": 10 // 合约维度的全局杠杆
   }

HTTP請求

GET /api/v1/positions

示例

GET /api/v1/positions

API權限

此接口需要通用權限

請求URL

此接口支持合約URL

頻率限制

合约类权重：2

參數

參數	數據類型	是否必須	含義
currency	String	否	幣種，比如XBT,USDT

返回值

參數	含義
id	倉位id
isInverse	是否反向合約
symbol	合約symbol
delevPercentage	ADL分位數
openingTimestamp	開倉時間
currentTimestamp	當前時間戳
currentQty	當前倉位數量
currentCost	當前倉位價值
currentComm	當前倉位總費用
unrealisedCost	未實現價值
realisedGrossCost	累計已實現毛利價值
realisedCost	累計已實現倉位價值
isOpen	是否開倉
markPrice	標記價格
markValue	標記價值
posCost	倉位價值
posInit	初始保證金 全倉=開倉價值/全倉杠桿；逐倉=每筆成交的初始保證金纍加
posMargin	倉位保證金 全倉=標記價值*imr；逐倉=倉位保證金（初始保證金、追加的保證金、產生的資金費用等纍加）
realisedGrossPnl	累計已實現毛利
realisedPnl	已實現盈虧
unrealisedPnl	未實現盈虧
unrealisedPnlPcnt	倉位盈虧率
unrealisedRoePcnt	投資回報率
avgEntryPrice	平均開倉價格
liquidationPrice	強平價格 全倉為參考强平價格，强平以風險率爲準
bankruptPrice	破產價格 全倉為參考破產價格，强平以風險率爲準
settleCurrency	結算幣種
crossMode	是否是全倉
marginMode	保證金模式，CROSS-全仓，ISOLATED-逐仓
positionSide	倉位方向
leverage	杠桿倍數
posFunding	仓位当前剩余未结算资金费用 僅逐倉適用
autoDeposit	是否自動追加保證金 僅逐倉適用
maintMarginReq	維持保證金率 僅逐倉適用
riskLimit	風險限額 僅逐倉適用
realLeverage	槓桿倍數 僅逐倉適用
posCross	追加到倉位的保證金 僅逐倉適用
posCrossMargin	追加的保證金（自動、手動、調整風險限額）僅逐倉適用
posComm	破產費用 僅逐倉適用
posCommCommon	破產費用的一部分（成倉、追加保證金）僅逐倉適用
posLoss	資金費用減少的資金 僅逐倉適用
posMaint	維持保證金 僅逐倉適用
maintMargin	包含未實現盈虧的倉位保證金 僅逐倉適用
maintainMargin	維持保證金率 僅逐倉適用