獲取倉位詳情
獲取用戶指定合約的倉位詳情
//逐倉
{
"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/position
示例
GET /api/v1/position?symbol=XBTUSDM
API權限
此接口需要通用權限
請求URL
此接口支持合約URL
頻率限制
合约类权重：2
參數
| 參數 | 數據類型 | 是否必須 | 含義 |
|---|---|---|---|
| symbol | String | 是 | 合約名稱 |
返回值
| 參數 | 含義 |
|---|---|
| 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 | 維持保證金率 僅逐倉適用 |
是
否