Comment créer un compte de trading de papier à terme sur OKX pour tester la stratégie ?

Création de compte et configuration de l'API

1. Connectez-vous à votre compte OKX et accédez à la section « Gestion des API » sous Paramètres du compte.

2. Cliquez sur « Créer une clé API » et attribuez un nom descriptif tel que « Futures-Backtest-Dev ».

3. Sélectionnez uniquement les autorisations « Trade » et « Read » : n'activez jamais les autorisations de retrait ou de financement pour les environnements de trading papier.

4. Définissez le paramètre flag sur « 1 » dans toutes les initialisations du SDK pour garantir la connexion à l'environnement de trading de démonstration.

5. Stockez la clé API, la clé secrète et la phrase secrète générées dans un fichier .env chiffré, non codé en dur dans les fichiers source.

Configuration de l'environnement spécifique aux contrats à terme

1. Accédez à l’interface de trading démo OKX directement via la plateforme web et passez en mode « Futures » avant de lancer toute stratégie.

2. Confirmez que le contrat sélectionné est un swap perpétuel avec marge USDT (par exemple, BTC-USDT-SWAP), car ils sont entièrement pris en charge dans l'environnement de trading papier.

3. Utilisez le module Account API pour récupérer le solde de marge et le mode de position avant de passer des commandes : accountAPI.get_position_mode() et accountAPI.get_account() .

4. Initialisez l'API Trade avec tdMode='cross' ou 'isolated' en fonction de votre modèle de risque prévu. Cela doit correspondre au mode configuré dans l'interface utilisateur Web d'OKX.

5. Vérifiez les spécifications du contrat à l'aide de MarketData.get_instruments(instType='SWAP') pour confirmer la taille du tick, la taille du lot et les limites de levier.

Exécution des ordres et validation de l’état

1. Soumettez un ordre limite test en utilisant tradeAPI.place_order() avec des paramètres réalistes : instId='ETH-USDT-SWAP' , ordType='limit' , px='3000' , sz='1' .

2. Récupérez l' ordId renvoyé et appelez immédiatement tradeAPI.get_order() pour confirmer la transition d'état de « en direct » à « rempli » ou « annulé ».

3. Vérifiez le statut de la commande avec tradeAPI.get_orders_history() pour valider la persistance et l'exactitude de l'horodatage dans le système de démonstration.

4. Simulez des exécutions partielles en soumettant plusieurs commandes de petite taille à des niveaux de prix adjacents et en inspectant les champs accFillSz et fillPx dans les charges utiles de réponse.

5. Déclenchez manuellement la liquidation forcée en ajustant la taille de la position au-delà des seuils de marge de maintenance et observez les événements de liquidation générés par le système dans Account.get_bills() .

Synchronisation des données et alignement temporel

1. Abonnez-vous au canal WebSocket books50-l2-tbt pour les instruments à terme afin de recevoir des mises à jour du carnet d'ordres en temps réel toutes les 10 millisecondes.

2. Enregistrez à la fois les horodatages fournis par l'échange ( msg['ts'] ) et les horodatages de réception locale ( time.time() * 1000 ) pour chaque message.

3. Détectez la dérive d'horloge en calculant le delta médian entre les horodatages locaux et d'échange sur 100 messages consécutifs.

4. Alignez la logique d'exécution des transactions avec l'instantané du carnet d'ordres le plus récent en utilisant l'heure locale comme référence principale (et non l'heure de la bourse) pour éviter les conditions de concurrence.

5. Stockez les charges utiles brutes de WebSocket ainsi que les états normalisés du carnet de commandes dans SQLite pour la relecture post-hoc et le profilage de latence.

Intégration du contrôle des risques

1. Implémentez une logique stop-loss stricte en interrogeant get_positions() toutes les 500 ms et en comparant le prix actuel avec les niveaux de déclenchement prédéfinis.

2. Appliquez des plafonds de taille de position par instrument à l'aide d'un grand livre local qui reflète le solde de marge get_account() et les calculs de marge utilisés.

3. Validez les paramètres d'effet de levier avant chaque soumission de commande en interrogeant get_leverage(instId='BTC-USDT-SWAP', mgnMode='cross') .

4. Simulez l'accumulation du taux de financement en calculant fundingRate × positionValue × timeElapsed et en l'appliquant à la marge disponible pendant les boucles de backtesting.

5. Enregistrez toutes les décisions liées aux risques, y compris les commandes rejetées en raison d'une marge insuffisante, au format JSON structuré avec une précision de la milliseconde.

Foire aux questions

Q1 : Puis-je utiliser la même clé API pour le trading de papier au comptant et à terme ? Oui, mais vous devez initialiser des instances TradeAPI distinctes avec des valeurs tdMode distinctes : « cash » pour le spot et « cross » ou « isolé » pour les contrats à terme.

Q2 : Pourquoi get_account() renvoie-t-il un solde nul en mode démo même après des dépôts réussis ? Les soldes de démonstration sont préchargés automatiquement lors de la première connexion à l'interface de démonstration de Futures ; la fonctionnalité de dépôt manuel est désactivée dans l’environnement de trading papier.

Q3 : Les taux de financement sont-ils appliqués au trading de papier à terme OKX ? Oui, les paiements de financement simulés ont lieu toutes les 8 heures en utilisant les taux de financement en temps réel du marché. Ceux-ci apparaissent dans get_bills() avec le type « financement ».

Q4 : Le canal WebSocket books50-l2-tbt reflète-t-il un flux de commandes synthétique ou des données d'échange réelles ? L'environnement de démonstration utilise un flux d'ordres synthétiques déterministe basé sur des modèles de volatilité historiques (et non sur des données d'échange en direct) mais maintient une fidélité structurelle totale, y compris la dynamique des spreads et le comportement de décroissance de la liquidité.