Comment utiliser le robot TWAP sur OKX ?

Comprendre la logique d'exécution TWAP

1. Les algorithmes de prix moyen pondéré dans le temps (TWAP) divisent un ordre important en ordres enfants plus petits exécutés à intervalles de temps réguliers sur une durée définie.

2. Le robot calcule la quantité totale et la répartit uniformément en secondes, minutes ou heures en fonction des fenêtres horaires spécifiées par l'utilisateur.

3. Chaque sous-ordre est soumis avec des paramètres de marché ou de limite, en respectant la taille minimale de commande d'OKX et les règles de cotation de prix pour l'instrument sélectionné.

4. L'algorithme ajuste dynamiquement le timing si la profondeur du marché change de manière significative, évitant ainsi les pics de dérapage pendant les périodes de faible liquidité.

5. Tous les horodatages d'exécution sont enregistrés en UTC et synchronisés avec l'API d'heure publique d'OKX pour éviter le rejet de signature en raison d'une dérive d'horloge.

Configuration des paramètres TWAP via python-okx

1. Instanciez TradeAPI avec le paramètre d'indicateur approprié : flag='1' pour l'environnement de démonstration ou flag='0' pour le trading en direct.

2. Définissez le dictionnaire de configuration TWAP contenant instId , tdMode , side , sz , targetTime et ordType .

3. Utilisez des objets Decimal pour tous les champs numériques afin d'éviter les erreurs de précision flottantes qui déclenchent des réponses OkxParamsException.

4. Transmettez la configuration à une fonction de planification TWAP personnalisée qui appelle place_order à plusieurs reprises avec des tailles de tranche calculées et des horodatages échelonnés.

5. Surveillez l'état via get_orders_ending et gérez les remplissages partiels en recalculant le volume restant et en ajustant les tranches suivantes.

Exigences de sécurité et d'authentification

1. Les clés API doivent être générées avec les autorisations Trade et Read activées explicitement dans la console de gestion API d'OKX.

2. La phrase secrète doit correspondre à celle utilisée lors de la création de la clé. Une incohérence entraîne un échec immédiat de l'authentification 401.

3. La clé secrète ne doit jamais apparaître dans le code source ; il ne doit être chargé qu'à partir d'un fichier .env chiffré à l'aide de python-dotenv.

4. La liste blanche IP est obligatoire pour une utilisation en production : le fait de ne pas la configurer entraîne des abandons de requêtes silencieux sans codes d'erreur.

5. La génération de signature doit suivre les spécifications exactes d'OKX : méthode + chemin + horodatage + corps haché avec HMAC-SHA256 à l'aide de la clé secrète.

Surveillance et gestion des erreurs

1. Implémentez un abonnement WebSocket en temps réel au canal des commandes pour recevoir des mises à jour instantanées au lieu d'une interrogation.

2. Enregistrez chaque soumission de commande avec la charge utile complète de la demande et le corps de la réponse pour garantir la conformité de la piste d'audit.

3. Détectez le code d'erreur 50113 comme incompatibilité de signature et resynchronisez automatiquement l'horloge système à l'aide de /api/v5/public/time .

4. Gérez le code 5 en introduisant un recul exponentiel avant de réessayer les tranches en attente.

5. Capturez les exceptions telles que RateLimitExceeded et InsufficientFunds pour interrompre l'exécution et alerter immédiatement l'opérateur.

Foire aux questions

Q : TWAP prend-il en charge les modes de marge croisée ou de marge de portefeuille ? Oui, définissez tdMode='cross' ou tdMode='portfolio' dans les paramètres de commande. La sélection du mode de marge affecte le calcul du solde disponible et les seuils de liquidation.

Q : Puis-je annuler une session TWAP active en cours d'exécution ? Oui, appelez Cancel_batch_orders avec la liste des ID de commande en attente renvoyée lors de la planification initiale. Toutes les tranches non exécutées seront supprimées de la file d'attente.

Q : Existe-t-il une fenêtre de temps minimale appliquée par OKX pour les stratégies TWAP ? OKX n'impose pas de minimum strict, mais l'exécution pratique nécessite au moins 60 secondes pour garantir une distribution significative et éviter de violer les limites de débit.

Q : Comment le robot gère-t-il la dislocation des prix lors des écarts de marché volatils ? Lorsque le prix dépasse la tolérance d’écart configurée, le bot met en pause les nouvelles soumissions et déclenche un indicateur de remplacement manuel. Il n'ajuste pas automatiquement les prix limites à moins d'être explicitement programmé avec une logique adaptative.