Comment passer un ordre au marché sur OKX sans dépasser votre marge disponible ?

Comprendre la disponibilité de la marge sur OKX

1. OKX calcule la marge disponible en temps réel en fonction des positions actuelles, du PnL non réalisé et des capitaux propres du compte dans tous les modes de trading, y compris la marge croisée et isolée.

2. La plateforme afficheavaMargin en tant que champ distinct dans la réponse du point de terminaison GET /api/v5/account/balance lors d'une requête avec un ID d'instrument et un mode de marge spécifiques.

3. La marge disponible est réduite de manière dynamique par l'exigence de marge initiale des positions ouvertes et augmentée ou diminuée en fonction du profit ou de la perte flottante.

4. Pour les ordres de marché en trading sur marge, OKX vérifie que la marge initiale requise de l'ordre ne dépasse pas la marge disponible calculée avant l'exécution.

5. Les utilisateurs doivent faire la distinction entreavaBal (solde disponible pour le spot) etavamargin (marge disponible pour les produits dérivés), car ils remplissent des fonctions de contrôle des risques fondamentalement différentes.

Validation au niveau de l'API avant la soumission de la commande

1. Avant de passer un ordre au marché, les développeurs doivent appeler le point de terminaison GET /api/v5/account/balance avec les paramètres instId , tdMode et ccy pour récupérer le dernier instantané de marge.

2. La réponse comprend un tableau details dans lequel chaque élément contientavaMargin , imr (exigence de marge initiale) et mmr (exigence de marge de maintenance).

3. Un script Python utilisant python-okx doit extraire la marge disponible et la comparer à la marge initiale estimée pour la taille de commande prévue en utilisant le prix actuel de l'instrument et le paramètre de levier.

4. Si la marge requise calculée dépasseavaMargin , le script doit interrompre la soumission et enregistrer un message de rejet explicite plutôt que de s'appuyer sur le code de rejet backend 51000 d'OKX.

5. Cette vérification préalable évite une consommation inutile de limite de débit API et évite les pannes silencieuses dues à des conditions de marge insuffisantes.

Paramètres d'ordre de marché qui influencent la consommation de marge

1. Le paramètre sz détermine directement la taille de la position et donc la marge initiale ; le doublement sz double la marge requise en supposant un effet de levier et un prix constants.

2. leverage est un facteur multiplicatif appliqué à la valeur notionnelle : un effet de levier plus élevé réduit proportionnellement la marge requise mais augmente le risque de liquidation.

3. px est ignoré pour les ordres de marché, OKX utilise donc le meilleur prix disponible du carnet d'ordres au moment de l'exécution, ce qui introduit une variation de marge liée au glissement.

4. tdMode doit être explicitement défini sur cross ou isolated ; Le mode croisé regroupe la marge entre les instruments, tandis que le mode isolé alloue la marge par instrument.

5. Le paramètre posSide affecte la logique d'allocation de marge en mode couverture, en particulier lorsque des positions longues et courtes existent simultanément sur le même instrument.

Surveillance des marges en temps réel via WebSocket

1. L'abonnement au canal account sous le flux private WebSocket fournit des mises à jour en direct pouravamargin chaque fois que les positions changent ou que le financement est réglé.

2. Chaque message contient les champs bal , availEq availMargin , permettant une logique de commande réactive sans interroger les points de terminaison REST.

3. Les champs ordLeavesQty et ordLeavesAmt dans les messages de mise à jour de commande reflètent l'impact sur la marge restante après des remplissages partiels.

4. L'utilisation de WebSocket élimine la latence entre les changements d'état de marge et la validation des commandes, essentielle pour les stratégies à haute fréquence fonctionnant à proximité des limites de marge.

5. Les développeurs doivent gérer les messages event: account avec le type update et filtrer les instType et ccy pertinents pour éviter de traiter les événements de compte non pertinents.

Foire aux questions

Q : OKX autorise-t-il les ordres au marché avec une marge disponible nulle s'il n'y a pas de positions ouvertes ? R : Non. Même sans position ouverte, OKX impose un tampon de marge minimum. Le champavaMargin n'autorisera jamais un ordre qui consomme 100 % des capitaux propres en raison des marges de sécurité intégrées.

Q : Puis-je passer un ordre au marché en utilisant l'USDT comme devise de marge sur un contrat perpétuel BTC-USDT ? R : Oui. Lorsque ccy=USDT et instId=BTC-USDT-SWAP , OKX traite l'USDT comme devise de marge et calculeavaMargin en termes USDT.

Q : Pourquoi mon ordre au marché échoue-t-il avec le code d'erreur 51000 même availMargin apparaît suffisant dans la dernière réponse de solde ? R : Parce que la disponibilité de la marge change entre le moment de la demande de solde et celui de la passation de la commande. Les mouvements de prix, les demandes de taux de financement ou les ajustements de position simultanés peuvent réduire la marge disponible en dessous du seuil requis au moment de la soumission.

Q : availMargin est-il identique availEq dans l'API de compte d'OKX ? R : Non.availEq fait référence aux capitaux propres disponibles utilisables pour ouvrir de nouvelles positions, tandis queavamargin reflète la partie des capitaux propres spécifiquement allouée et disponible pour l'utilisation de la marge dans les paramètres et positions actuels.