ETHUSDT先物のポジションサイズを確認するにはどうすればよいですか?

Binance REST API 経由で先物ポジションデータにアクセスする

1. ユーザーは、有効な API 資格情報と適切な署名認証を使用して/fapi/v2/positionRiskエンドポイントを呼び出すことにより、リアルタイムの ETHUSDT 無期限先物ポジション サイズを取得します。

2. リクエストには、拒否を避けるために、 X-MBX-APIKEYヘッダーと、Binance サーバー時間の±60,000 ミリ秒以内に調整されたタイムスタンプ パラメーターが含まれている必要があります。

3.シンボル=ETHUSDTとタイムスタンプを含む署名付きクエリ文字列が、HMAC-SHA256 とユーザーの秘密キーを使用して生成されます。

4. 応答ペイロードは、各オブジェクトがアカウント内の位置に対応する配列を返します。 ETHUSDT の場合、関連するエントリには、 positionAmt 、 entryPrice 、およびunRealizedProfitなどのフィールドが含まれます。

5.positionAmtフィールドは、契約の正味ポジション サイズを示します。正の値は長期エクスポージャーを表し、負の値は短期エクスポージャーを示します。

ポジション金額と契約単位の解釈

1. ETHUSDT USD-M 先物の場合、1 つの契約は 0.01 ETH を表します。これは、 positionAmt = 100が 1 ETH のロングポジションに等しいことを意味します。

2. notionalValueフィールドには、現在のマーク価格での USDT で表されるポジション サイズが反映され、手動変換なしで即時評価が可能になります。

3. レバレッジ設定は生のpositionAmt値を変更しませんが、同じ応答に表示される証拠金の使用量と清算のしきい値に直接影響します。

4. 分離モードとクロスマージン モードに複数のポジションが存在する場合、それぞれが別個のmarginType フィールドと孤立マージンフィールドを持つ別個の配列要素として表示されます。

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 が比例的に減少し、修正された値と更新されたLiquidationPriceによる即時の WebSocket 更新がトリガーされます。