Tradovate API

Enregistrer une application OAuth dans Tradovate

Apprenez à enregistrer une application OAuth pour que des outils tiers se connectent en toute sécurité à votre compte de trading de contrats à terme, avec la configuration de l'URI de redirection et des autorisations.

On This Page

Si vous développez un outil que d'autres traders connecteront à leur compte Tradovate, vous ne voulez pas demander à chacun son identifiant et son mot de passe. C'est tout l'intérêt d'OAuth. L'enregistrement d'une application OAuth fournit à votre intégration un client ID et un client secret, et permet à vos utilisateurs d'accorder l'accès via un véritable écran de connexion plutôt que de vous confier leurs identifiants bruts. Voici comment en configurer une depuis votre propre compte.

Un petit rappel avant de commencer : si vous n'automatisez que votre propre compte, vous n'avez probablement pas besoin d'OAuth. Une simple clé API avec le flux d'authentification par identifiant et mot de passe est plus simple et fait très bien l'affaire. OAuth prend tout son sens lorsque des tiers se connectent via votre application.

Ce dont vous avez besoin au préalable

  • Un compte Tradovate actif disposant d'un accès à l'API.
  • Les conditions de l'API signées (une étape rapide et unique, détaillée ci-dessous).
  • Un URI de redirection, c'est-à-dire l'URL de rappel sur laquelle votre application écoute après la connexion d'un utilisateur.

Une réserve concernant les comptes de prop firms et d'évaluation : la disponibilité de l'API et d'OAuth varie selon la société et le type de compte ; vérifiez donc les règles actuelles de votre société avant de compter dessus.

Enregistrer une application OAuth dans Tradovate : étape par étape

1

Signer les conditions de l'API

Avant que les options OAuth n'apparaissent, Tradovate vous demande de remplir une auto-attestation et de signer l'accord numérique couvrant les conditions générales de son API. C'est une étape unique. Lisez-le, acceptez-le, et les options pour développeurs s'ouvrent.

2

Ouvrir API Access et choisir l'enregistrement OAuth

Ouvrez Application Settings, puis rendez-vous dans l'onglet API Access. Vous y verrez les options de l'API. Choisissez OAuth Registration pour créer une nouvelle application. C'est la même zone de paramètres que celle utilisée pour générer une clé API standard ; si vous y êtes déjà allé, elle vous sera familière.

3

Renseigner les détails de l'application

Le formulaire d'enregistrement demande deux champs obligatoires : App Title, le nom que les utilisateurs voient sur l'écran de consentement lorsqu'ils autorisent votre application, et Redirect URI, l'adresse vers laquelle Tradovate renvoie l'utilisateur après sa connexion. Elle doit correspondre, caractère pour caractère, à l'URI de redirection que votre application enverra plus tard dans la demande d'autorisation. Une barre oblique finale ou un mauvais port suffisent à casser le flux. Vous pouvez aussi ajouter un lien vers une politique de confidentialité, un lien vers des conditions générales et téléverser un logo. Ces éléments sont facultatifs, mais ils donnent un aspect légitime à l'écran de consentement, ce qui compte lorsque des inconnus confient à votre application l'accès à leur compte.

4

Définir les autorisations

Plus bas dans le formulaire, vous choisissez les autorisations que les utilisateurs accorderont en passant par votre application. Restez strict. Ne demandez que ce que votre intégration utilise réellement. Des périmètres restreints inspirent davantage confiance et sont plus faciles à analyser si un problème survient.

5

Générer et conserver vos clés

Lorsque le formulaire est correct, cliquez sur Generate. Tradovate vous affiche la clé une seule fois. Copiez immédiatement le client ID et le secret et placez-les en lieu sûr, par exemple dans un gestionnaire de secrets ou un fichier d'environnement côté serveur. Ne publiez jamais le secret dans un dépôt public. Si vous le perdez, vous devrez tout recommencer depuis le début.

Mettre les identifiants au travail

Une fois que vous avez le client ID et le secret, le flux est un échange classique de code d'autorisation OAuth. Envoyez l'utilisateur vers l'URL d'autorisation, récupérez le code à usage unique sur votre URI de redirection, puis échangez ce code contre un jeton d'accès côté serveur.

URL d'autorisation : https://trader.tradovate.com/oauth avec response_type=code, client_id et redirect_uri

URL d'échange de jeton : https://live.tradovateapi.com/auth/oauthtoken

Corps de l'échange de jeton : grant_type=authorization_code, client_id, client_secret, redirect_uri, code

L'URI de redirection dans l'échange de jeton doit correspondre à celui de la demande d'autorisation, qui doit lui-même correspondre à celui que vous avez enregistré à l'étape 3. Les jetons d'accès expirent ; prévoyez donc une routine de renouvellement plutôt que de réautoriser sans cesse les utilisateurs.

Quelques pièges fréquents

Les incohérences d'URI de redirection sont la première cause d'échec de la négociation d'une nouvelle application OAuth ; verrouillez donc ce point en priorité. L'autre piège est la clé à affichage unique : beaucoup passent l'écran Generate sans y prêter attention, perdent le secret et doivent tout refaire. Considérez cet écran comme la seule fois où vous le verrez, car c'est exactement le cas.

Automatiser avec PickMyTrade

Vous voulez l'automatisation sans créer vous-même une application OAuth ? PickMyTrade connecte TradingView à Tradovate pour vous, afin que vous puissiez acheminer des alertes vers votre compte sans écrire une seule ligne de code OAuth.

Évitez de créer votre propre application OAuth

Laissez PickMyTrade connecter TradingView à Tradovate pour vous, sans aucun code OAuth.

Commencez votre essai gratuit de 7 jours

Guides associés

Tradovate : OAuth vs authentification par clé API Accéder aux actualités du marché dans Tradovate S'entraîner avec Tradovate Market Replay

Ce guide est fourni uniquement à des fins éducatives et informatives et ne constitue pas un conseil financier, d'investissement ou 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 » ainsi que 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 actuelle sur la plateforme et dans la documentation officielles de Tradovate avant d'agir.