Comment vérifier si une commande Spot Binance est partiellement exécutée

Comprendre les champs de statut de la commande

1. Le champ d'état dans la réponse à la commande de Binance indique l'étape actuelle du cycle de vie : NEW , PARTIALLY_FILLED , FILLED , CANCELED ou REJECTED .

2. Une valeur PARTIALLY_FILLED signifie qu'au moins un remplissage a eu lieu mais que l' origQty complète reste inexécutée.

3. Ce statut est renvoyé immédiatement lors de la première exécution partielle, que d'autres exécutions soient ou non attendues.

4. Il persiste jusqu'à ce que la quantité restante soit entièrement exécutée ou que la commande soit annulée manuellement.

5. Les mises à jour de statut sont fournies via la réponse REST sur get_order et diffusées en temps réel via les événements de flux de données utilisateur .

Analyser les quantités d'exécution

1. Comparez exécutéQty avec origQty : si exécutéQty est supérieur à zéro mais inférieur à origQty , la commande est partiellement exécutée.

2. Examinez cummulativeQuoteQty : il reflète la valeur totale de l'actif de cotation correspondant jusqu'à présent et doit être différent de zéro en cas de remplissage partiel.

3. Inspectez le tableau de remplissages : une liste non vide confirme qu'au moins une exécution de transaction a eu lieu.

4. Chaque entrée des remplissages contient price , qty , commission et tradeId , fournissant une preuve granulaire d'une exécution partielle.

5. Notez que exécutéQty et cumulativeQuoteQty sont des valeurs décimales de type chaîne ; la comparaison directe des flotteurs doit être évitée pour éviter une perte de précision.

Utilisation du point de terminaison de l'API get_order

1. Appelez trade.get_order(symbol='BTCUSDT', orderId=123456789) avec des informations d'identification valides et la casse correcte du symbole.

2. Analysez l'objet de données à l'intérieur de la réponse – ne vous fiez pas uniquement au code de niveau supérieur ou aux champs msg .

3. Extrayez status , exécutéQty , origQty et les remplissages de la charge utile de données imbriquées.

4. Validez la cohérence numérique : assurez-vous que exécutéQty ≤ origQty et cumulativeQuoteQty correspondent à la somme du prix × la quantité pour tous les remplissages .

5. Traitez tout écart par rapport à cet invariant comme une anomalie nécessitant un rapprochement manuel ou une enquête en amont.

Surveillance via le flux de données utilisateur

1. Abonnez-vous à l' événementexecutionReport sous une connexion WebSocket de flux de données utilisateur valide.

2. Filtrez les messages où eventType est égal à exécutéReport et le symbole correspond à la paire de trading cible.

3. Détectez les remplissages partiels en vérifiant que le type d'exécution est égal à TRADE tandis que orderStatus reste PARTIALLY_FILLED .

4. Accumulez lastExecutedQuantity et lastPrice de chaque exécutionReport pour reconstruire l'historique de remplissage sans interrogation.

5. Utilisez eventTime pour séquencer les remplissages par ordre chronologique et identifier les lacunes ou les rapports en double causés par la gigue du réseau ou la reconnexion.

Foire aux questions

Q : Le statut PARTIALLY_FILLED peut-il revenir à NEW après avoir été signalé ? R : Non. La machine à états d'ordre de Binance est strictement monotone. Une fois PARTIALLY_FILLED émis, il passe uniquement à FILLED , CANCELED ou EXPIRED .

Q : Est-ce que get_orders_ending inclut les commandes partiellement exécutées ? R : Oui. get_orders_ending renvoie toutes les commandes ouvertes, y compris celles avec le statut PARTIALLY_FILLED et la quantité restante non exécutée.

Q : Y a-t-il un délai entre un remplissage et l'apparition de la mise à jour du statut dans get_order ? R : Dans des conditions normales, l'API REST reflète le dernier état dans un délai de 100 millisecondes. Une latence plus élevée peut survenir pendant les fenêtres de maintenance d'échange ou des échecs de routage d'API régionaux.

Q : Qu'arrive-t-il au tableau fills lorsqu'un ordre est annulé après une exécution partielle ? R : Le tableau de remplissages reste intact et inchangé. L'annulation n'affecte que l'exécution future ; Les remplissages historiques sont immuables et conservés dans l'enregistrement de la commande.