Comment vérifier l'historique des bénéfices des contrats à terme OKX ? Tutoriel complet

Accès à l'historique des bénéfices à terme via l'interface Web OKX

1. Connectez-vous à votre compte OKX à l'aide d'informations d'identification vérifiées et accédez à la section « Actifs » dans la barre de navigation supérieure.

2. Sélectionnez « Futures » dans le menu déroulant pour accéder au tableau de bord du portefeuille de contrats à terme.

3. Cliquez sur l'onglet « Historique » situé directement sous le panneau de résumé du solde.

4. Choisissez « Profits et pertes » dans les options de filtre : cela affiche toutes les entrées PnL réalisées triées par ordre chronologique.

5. Utilisez le sélecteur de plage de dates pour spécifier les horodatages de début et de fin ; la vue par défaut affiche les 30 derniers jours mais prend en charge jusqu'à 90 jours par requête.

Récupération des données sur les bénéfices via l'API python-okx

1. Initialisez le module AccountAPI avec des informations d'identification API valides et définissez flag='1' pour un environnement de trading réel.

2. Appelez get_position_history() avec des paramètres tels que instType='SWAP' , instId='BTC-USDT-SWAP' et limit=100 .

3. Analysez les données de réponse pour extraire des champs tels que réaliséPnl , fee , ts (horodatage) et ordId pour chaque position fermée.

4. Regroupez les résultats sur plusieurs pages en itérant avec les valeurs du curseur avant et après jusqu'à ce qu'aucun autre enregistrement ne soit renvoyé.

5. Convertissez les horodatages bruts en millisecondes au format ISO 8601 pour plus de lisibilité et alignez-les sur les paramètres de fuseau horaire local à l'aide de la bibliothèque datetime de Python.

Comprendre la logique de calcul des bénéfices sur OKX Futures

1. Le profit réalisé est calculé à la clôture de la position et est égal à (exitPrice - EntryPrice) × positionSize × contractMultiplier pour les positions longues.

2. Pour les positions courtes, la formule s'inverse : (entryPrice - exitPrice) × positionSize × contractMultiplier .

3. Les frais sont déduits séparément et comprennent les tarifs preneur/fabricant ainsi que les frais de règlement du financement appliqués à intervalles périodiques.

4. Les PnL non réalisés sont exclus des rapports de bénéfices historiques : ils apparaissent uniquement dans le suivi actif des positions et sont réinitialisés à la clôture.

5. Les modes de marge croisée et de marge isolée affectent les seuils d'allocation des frais et de liquidation, mais ne modifient pas l'arithmétique de base du PnL.

Options d'exportation de données et de stockage local

1. Dans l'interface Web OKX, cliquez sur le bouton « Exporter » à côté du tableau PnL pour télécharger un fichier CSV contenant toutes les lignes visibles.

2. Le fichier exporté comprend les colonnes : Date , Instrument , Côté , Taille , Prix d'entrée , Prix de sortie , PnL réalisé , Frais et Bénéfice net .

3. Lorsque vous utilisez python-okx, construisez un Pandas DataFrame à partir des réponses de l'API et enregistrez-le localement avec df.to_csv('okx_futures_pnl.csv', index=False) .

4. Activez l'exportation quotidienne automatique en planifiant une tâche cron qui déclenche un script récupérant les enregistrements PnL de la veille en utilisant des horodatages avant et après .

5. Stockez les sauvegardes cryptées des fichiers exportés à l'aide des outils de cryptage AES-256 pour vous conformer aux exigences de protection des données personnelles.

Foire aux questions

Q1 : Puis-je récupérer l’historique des bénéfices datant de plus de 90 jours via l’interface Web OKX ? Non. L’interface Web impose une limite stricte de 90 jours pour la récupération directe. Pour accéder aux enregistrements plus anciens, utilisez la méthode python-okx get_position_history() avec une gestion de pagination appropriée.

Q2 : Pourquoi mon CSV exporté n'affiche-t-il aucun frais pour certaines positions ? Cela se produit lorsque la position a été ouverte et fermée pendant une période de remise du fabricant ou n'a impliqué aucune consommation de liquidité du preneur. Les frais de financement peuvent également être absents si la durée de la position diminue entre les cycles de règlement.

Q3 : Le PnL réalisé est-il affiché avant ou après déductions fiscales ? OKX n'effectue pas de retenue d'impôt. Toutes les valeurs PnL indiquées sont des montants bruts avant toute obligation fiscale juridictionnelle.

Q4 : L'API renvoie-t-elle des PnL non réalisés dans les points de terminaison de l'historique des bénéfices ? Non. Les points de terminaison comme get_position_history() fournissent exclusivement des données finalisées et fermées. Les valeurs non réalisées apparaissent uniquement dans les instantanés de position en temps réel via get_positions() .