Lire positions, exécutions et solde via l’API Tradovate
Vous souhaitez récupérer vos comptes Tradovate, positions ouvertes, exécutions et solde de trésorerie directement depuis les endpoints REST ? Voici chaque appel de lecture, étape par étape.
On This Page
Vous souhaitez récupérer les données de compte de l’API Tradovate, c’est-à-dire vos comptes, positions ouvertes, exécutions et solde de trésorerie, directement depuis les endpoints REST ? Que vous construisiez un tableau de bord, rapprochiez vos exécutions au moment des impôts ou mettiez en place une automatisation comme PickMyTrade, ce guide vous présente chaque appel de lecture, étape par étape.
Qu’est-ce que l’API de données de compte Tradovate ?
Tradovate expose une API REST dans laquelle chaque objet de compte (comptes, positions, exécutions, ordres et soldes) dispose d’un endpoint de lecture correspondant. Dès que vous possédez un jeton d’accès valide, une poignée d’appels GET et POST renvoient ces données au format JSON. Vous pouvez ainsi reproduire exactement ce que vous voyez dans l’application Trader au sein de vos propres outils.
Lire les données de compte de l’API Tradovate : étape par étape
Authentifiez-vous et définissez votre URL de base
Demandez un jeton d’accès en envoyant vos identifiants par POST à auth/accessTokenRequest, puis transmettez ce jeton à chaque appel dans l’en-tête Authorization: Bearer <accessToken>. Utilisez l’hôte de démo demo.tradovateapi.com/v1 pour les comptes simulés et live.tradovateapi.com/v1 pour les comptes approvisionnés. Les jetons expirent ; renouvelez donc le vôtre avant son expiration, faute de quoi l’appel suivant renverra une erreur 401 Unauthorized.
Listez vos comptes
Appelez GET account/list pour obtenir tous les comptes associés à votre connexion. Chaque élément inclut l’id numérique, le name et le userId. Conservez cet id numérique : la plupart des appels suivants s’appuient dessus, et il ne correspond pas au surnom du compte que vous voyez dans l’application.
Lisez vos positions ouvertes
Appelez GET position/list pour obtenir les positions actuelles. Les champs qui vous intéressent sont netPos (contrats nets signés, une valeur négative signifie une position vendeuse), contractId (associez-le à un symbole avec contract/item?id=) et netPrice, le prix d’entrée moyen. Un piège : netPrice n’est pas toujours renseigné sur une position fraîchement ouverte ; prévoyez donc ce cas dans votre code.
Récupérez vos exécutions et ordres
Appelez GET fill/list pour les exécutions et GET order/list pour les enregistrements d’ordres. Tous deux suivent le modèle {entity}/list et renvoient des tableaux pour votre utilisateur. Gardez à l’esprit que ces endpoints de liste sont conçus pour l’activité récente et ne renverront pas toujours l’intégralité de votre historique de trades. Pour un chargement historique complet, utilisez l’API de Reporting, puis abonnez-vous à user/syncrequest via WebSocket pour recevoir les mises à jour en temps réel.
Vérifiez le solde de trésorerie et la marge
Pour le solde, envoyez par POST l’id numérique du compte à cashBalance/getCashBalanceSnapshot. Cet appel renvoie les dernières valeurs de trésorerie et de marge, la valeur totale de la trésorerie, le P&L ouvert et la marge utilisée, ce qui est le moyen le plus rapide de lire le solde réalisé sans parcourir tout le journal de trésorerie. Envoyez { "accountId": <id> } dans le corps de la requête.
Pourquoi vous en avez besoin
- Audit et rapprochement, comparez exécutions et P&L à vos relevés de courtier.
- Documents fiscaux, exportez les exécutions et les soldes réalisés de l’année.
- Tableaux de bord personnalisés, affichez positions et solde en direct en dehors de l’application Trader.
- Alimenter une stratégie, laissez un bot lire l’exposition actuelle avant de dimensionner le prochain ordre.
Automatisez cela avec PickMyTrade
Si vous préférez ne pas gérer vous-même le renouvellement des jetons, les limites de débit et la plomberie des endpoints, PickMyTrade relie vos alertes TradingView directement à votre compte Tradovate. Les ordres s’exécutent et les positions se mettent à jour automatiquement, sans appels API manuels.
Oubliez la plomberie des endpoints
Laissez PickMyTrade relier vos alertes TradingView directement à votre compte Tradovate : les ordres s’exécutent et les positions se mettent à jour automatiquement.
Commencez votre essai gratuit de 7 joursQuestions fréquentes
Pas de façon fiable. fill/list et order/list conviennent surtout à l’activité récente. Pour un export historique complet, utilisez l’API de Reporting plutôt que de paginer les endpoints de liste.
netPrice n’est pas garanti sur chaque objet de position, surtout juste après l’entrée. Vérifiez-le toujours contre null et rabattez-vous sur vos propres données d’exécution si vous avez besoin du prix moyen immédiatement.
Utilisez demo.tradovateapi.com pour les comptes simulés et live.tradovateapi.com pour les comptes approvisionnés. Des limites de débit s’appliquent et varient ; limitez donc la fréquence de vos requêtes et consultez les limites en vigueur chez Tradovate.
Ce guide est fourni à des fins strictement éducatives et informatives et ne constitue ni un conseil financier, ni un conseil en investissement, ni un conseil de trading. Le trading de contrats à terme et d’autres produits à effet de levier comporte un risque de perte important et ne convient pas à tous les investisseurs. PickMyTrade est une plateforme d’automatisation tierce indépendante et n’est ni affiliée à Tradovate, Inc., ni approuvée, ni parrainée par cette dernière. « Tradovate » et tous les noms, logos et marques associés sont la propriété de leurs détenteurs respectifs. Les fonctionnalités et les étapes de la plateforme évoluent avec le temps ; vérifiez donc toujours la procédure en vigueur dans la plateforme et la documentation officielles de Tradovate avant d’agir.