跳到主要内容

用户持仓风险V3 (USER_DATA)

接口描述

查询持仓风险,仅返回有持仓或挂单的交易对

HTTP请求

GET /fapi/v3/positionRisk

请求权重

5

请求参数

名称类型是否必需描述
symbolSTRINGNO
recvWindowLONGNO
timestampLONGYES

注意

  • 请与账户推送信息ACCOUNT_UPDATE配合使用,以满足您的及时性和准确性需求。

响应示例

单向持仓模式下:

[
{
"symbol": "ADAUSDT",
"positionSide": "BOTH", // 持仓方向
"positionAmt": "30",
"entryPrice": "0.385",
"breakEvenPrice": "0.385077",
"markPrice": "0.41047590",
"unRealizedProfit": "0.76427700", // 持仓未实现盈亏
"liquidationPrice": "0",
"isolatedMargin": "0",
"notional": "12.31427700",
"marginAsset": "USDT",
"isolatedWallet": "0",
"initialMargin": "0.61571385", // 初始保证金
"maintMargin": "0.08004280", // 维持保证金
"positionInitialMargin": "0.61571385",// 仓位初始保证金
"openOrderInitialMargin": "0", // 订单初始保证金
"adl": 2,
"bidNotional": "0",
"askNotional": "0",
"updateTime": 1720736417660 // 更新时间
}
]

双向持仓模式下:

[
{
"symbol": "ADAUSDT",
"positionSide": "LONG",
"positionAmt": "30",
"entryPrice": "0.385",
"breakEvenPrice": "0.385077",
"markPrice": "0.41047590",
"unRealizedProfit": "0.76427700",
"liquidationPrice": "0",
"isolatedMargin": "0",
"notional": "12.31427700",
"marginAsset": "USDT",
"isolatedWallet": "0",
"initialMargin": "0.61571385",
"maintMargin": "0.08004280",
"positionInitialMargin": "0.61571385",
"openOrderInitialMargin": "0",
"adl": 2,
"bidNotional": "0",
"askNotional": "0",
"updateTime": 1720736417660
},
{
"symbol": "COMPUSDT",
"positionSide": "SHORT",
"positionAmt": "-1.000",
"entryPrice": "70.92841",
"breakEvenPrice": "70.900038636",
"markPrice": "49.72023376",
"unRealizedProfit": "21.20817624",
"liquidationPrice": "2260.56757210",
"isolatedMargin": "0",
"notional": "-49.72023376",
"marginAsset": "USDT",
"isolatedWallet": "0",
"initialMargin": "2.48601168",
"maintMargin": "0.49720233",
"positionInitialMargin": "2.48601168",
"openOrderInitialMargin": "0",
"adl": 2,
"bidNotional": "0",
"askNotional": "0",
"updateTime": 1708943511656
}
]