如何查看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 ，紅色表示負部位－必須僅反映符號，與獲利/虧損狀態或槓桿水準無關。

常見問題解答

Q：為什麼下限價單後positionAmt仍顯示0？部位規模僅反映已成交的合約；未履行的訂單出現在openOrders下，而非部位。

Q：我可以查看過期交割合約的部位規模嗎？否－只有當前期貨市場上市支援的活躍交易品種才會出現在頭寸回應中；過期合約被完全排除在外。

Q：positionAmt是否包含透過API子帳戶持有的部位？否 - 每個 API 金鑰僅存取其自己的主帳戶或明確委託的子帳戶；跨子帳戶聚合需要每個金鑰單獨的經過驗證的呼叫。

Q：positionAmt 是否會受到部分強平的影響？是的－部分清算會按比例減少positionAmt ，並立即觸發WebSocket更新，更新值和更新後的liquidationPrice 。