如何查看ETHUSDT期货持仓规模？

通过币安 REST API 访问期货头寸数据

1. 用户通过使用有效的 API 凭证和正确的签名身份验证调用/fapi/v2/positionRisk端点来检索实时 ETHUSDT 永续合约持仓规模。

2. 请求必须包含X-MBX-APIKEY标头和时间戳参数，且与币安服务器时间的 ±60,000 毫秒内对齐，以避免被拒绝。

3. 使用 HMAC-SHA256 和用户的密钥生成包含符号 = ETHUSDT和时间戳的签名查询字符串。

4. 响应负载返回一个数组，其中每个对象对应账户中的一个位置；对于 ETHUSDT，相关条目包含positionAmt 、 entryPrice和unRealizedProfit等字段。

5、 positionAmt字段表示合约净持仓规模，正值表示多​​仓，负值表示空仓。

头寸金额和合约单位解读

1. 对于ETHUSDT USD-M期货，一份合约代表0.01 ETH，即positionAmt = 100等于1 ETH多头头寸。

2. notionalValue字段反映的是按当前标记价格以USDT表示的持仓规模，无需手动换算即可立即估值。

3. 杠杆设置不会改变原始positionAmt值，但会直接影响同一响应中显示的保证金使用和清算阈值。

4. 如果跨保证金模式和全仓保证金模式存在多个仓位，则每个仓位均显示为具有不同marginType和isolatedMargin字段的单独数组元素。

5. 零值positionAmt确认该交易品种没有未平仓头寸，无论最近的订单历史记录或待处理的触发情况如何。

使用 WebSocket 流进行实时更新

1. 订阅!account用户数据流可在执行、清算或调整时立即提供仓位更新，从而绕过 REST 延迟。

2. 每条消息都包含一个与 REST 响应结构相同的位置数组，允许直接映射到本地状态而无需轮询。

3. 每个仓位对象内的updateTime字段都带有毫秒精度的 UNIX 时间戳，这对于与烛台或订单簿流同步至关重要。

4. WebSocket 消息还包含crossWalletBalance和availableBalance ，提供上下文保证金健康状况以及头寸规模。

5、重连逻辑必须保持listenKey的有效性；未能每 60 分钟刷新一次会导致流终止并失去位置增量连续性。

客户端解析和显示注意事项

1. 解析原始 JSON 的前端应用程序必须在渲染之前验证positionAmt是否存在，因为缺少键表示零位置或权限受限的帐户范围。

2、小数点精度处理是强制的：ETHUSDT的positionAmt使用3位小数，截断错误会导致显示大小与实际曝光量不一致。

3. 当多个交易品种在同一账户中处于活动状态时，按交易品种对仓位数组进行排序可确保确定性的渲染顺序。

4. WebSocket 有效负载中的空或 null位置数组需要显式的 UI 回退——在不比较序列号的情况下不应假设“无变化”。

5. 颜色编码指标——绿色表示正头寸Amt ，红色表示负头寸——必须仅反映符号，与盈利/亏损状态或杠杆水平无关。

常见问题解答

问：为什么下限价单后positionAmt仍显示0？头寸规模仅反映已成交的合约；未履行的订单出现在openOrders下，而不是仓位下。

问：我可以查看过期交割合约的头寸规模吗？否——只有当前期货市场上市支持的活跃交易品种才会出现在头寸响应中；过期合同被完全排除在外。

问：positionAmt是否包含通过API子账户持有的仓位？否 - 每个 API 密钥仅访问其自己的主账户或明确委托的子账户；跨子帐户聚合需要每个密钥单独的经过身份验证的调用。

问：positionAmt 是否会受到部分强平的影响？是的——部分清算会按比例减少positionAmt ，并立即触发WebSocket更新，更新值和更新后的liquidationPrice 。