Binance スポット注文が部分的に約定されたかどうかを確認する方法

注文ステータスフィールドについて

1. Binance の注文応答のステータスフィールドは、現在のライフサイクル ステージ ( NEW 、 PARTIALLY_FILLED 、 FILLED 、 CANCELED 、またはREJECTED )を示します。

2. PARTIALLY_FILLEDの値は、少なくとも 1 回のフィルが発生したが、完全なorigQtyが実行されていないことを意味します。

3. このステータスは、さらなるフィルが期待されるかどうかに関係なく、最初の部分実行時にすぐに返されます。

4. 残りの数量が完全に実行されるか、注文が手動でキャンセルされるまで、この状態は継続します。

5. ステータスの更新は、 get_order のREST 応答を介して配信され、ユーザー データ ストリームイベントを通じてリアルタイムでストリーミングされます。

約定数量の分析

1. selectedQty をorigQtyと比較します。executedQtyが0 より大きく、 origQtyより小さい場合、注文は部分的に約定されます。

2.cummulativeQuoteQtyを調べます。これは、これまでに一致した見積資産価値の合計を反映しており、部分約定が存在する場合はゼロ以外である必要があります。

3. fills配列を検査します。空でないリストは、少なくとも 1 つの取引執行が行われたことを確認します。

4.約定の各エントリには、 price 、 qty 、 Commission 、 tradeIdが含まれており、部分執行の詳細な証拠を提供します。

5.executedQtyとcummulativeQuoteQtyは文字列型の 10 進数値であることに注意してください。精度の低下を防ぐために、float の直接比較は避けてください。

get_order API エンドポイントの使用

1. 有効な資格情報と正しいシンボルの大文字小文字を使用してtrade.get_order(symbol='BTCUSDT', orderId=123456789)を呼び出します。

2. 応答内のデータオブジェクトを解析します。トップレベルのコードやメッセージフィールドだけに依存しないでください。

3. ネストされたデータペイロードからstatus 、 selectedQty 、 origQty 、およびfillsを抽出します。

4. 数値の一貫性を検証します。executedQty ≤ origQtyであり、 cummulativeQuoteQty がすべての約定の価格 × 数量の合計と一致することを確認します。

5. この不変条件からの逸脱は、手動による調整または上流の調査が必要な異常として扱います。

ユーザーデータストリームによる監視

1. 有効なユーザー データ ストリーム WebSocket 接続で、 executionReportイベントをサブスクライブします。

2.eventTypeがexecutionReportに等しく、シンボルがターゲット取引ペアに一致するメッセージをフィルタリングします。

3. orderStatusがPARTIALLY_FILLED のままである間に、 executionType がTRADEに等しいかどうかをチェックして、部分約定を検出します。

4. 各実行レポートからlastExecutedQuantityとlastPriceを蓄積し、ポーリングせずに約定履歴を再構築します。

5.eventTimeを使用してフィルを時系列に並べ、ネットワークのジッターや再接続によって引き起こされるギャップや重複レポートを特定します。

よくある質問

Q: 報告後に PARTIALLY_FILLED ステータスを NEW に戻すことはできますか? A: いいえ。Binance の注文ステートマシンは厳密に単調です。 PARTIALLY_FILLEDが発行されると、 FILLED 、 CANCELED 、またはEXPIREDにのみ遷移します。

Q: get_orders_pending には部分的に約定された注文も含まれますか? A: はい。 get_orders_pending は、 PARTIALLY_FILLEDステータスの注文や未約定数量が残っている注文を含む、すべての未処理の注文を返します。

Q: フィルが発生してから get_order に表示されるステータス更新の間に遅延はありますか? A: 通常の状態では、REST API は 100 ミリ秒以内に最新の状態を反映します。 Exchange のメンテナンス期間中または地域 API ルーティングの障害により、遅延が長くなる可能性があります。

Q: 注文が部分的に実行された後にキャンセルされた場合、fills 配列はどうなりますか? A:塗りつぶし配列はそのまま残り、変更されません。キャンセルは将来の実行にのみ影響します。過去の約定は不変であり、注文レコードに保存されます。