Qu’est-ce que l’operatorId et pourquoi est-il obligatoire ? – Bitvavo Centre d'assistance

Résumé

Cet article explique ce qu’est le paramètre operatorId, pourquoi il est requis par la réglementation, et comment l’utiliser correctement lors de la création d’un ordre via l’API Bitvavo. Si vous utilisez des bots ou des scripts pour passer des ordres via l’API, cet article vous aidera à comprendre comment définir et intégrer l’operatorId dans le corps de la requête.

Qu’est-ce que l’operatorId ?

L’operatorId est un paramètre obligatoire pour toute requête API liée aux opérations de trading, comme la création d’un ordre. Ce champ a été introduit dans le cadre des obligations réglementaires et permet d’identifier clairement quel bot, script ou système a passé un ordre à partir de votre compte.

Il s’agit d’un entier de type int64 (nombre entier long), que vous devez définir vous-même. Nous recommandons une valeur comprise entre 1 et 9 223 372 036 854 775 807.

Si vous utilisez plusieurs bots ou scripts sous une même clé API, l’operatorId permet de distinguer facilement l’origine de chaque ordre.

Pourquoi est-ce obligatoire ?

Les nouvelles réglementations sur les crypto-actifs exigent une traçabilité accrue des activités de trading. C’est pourquoi l’operatorId :

Permet d’identifier l’émetteur d’un ordre dans votre compte
Est requis pour chaque requête de trading via l’API
Ne peut pas être omis ou désactivé
Doit être unique pour chaque système ou script qui envoie des requêtes

Comment utiliser l’operatorId ?

L’operatorId est un nombre entier (int64) que vous devez attribuer vous-même. Par exemple : 12234 pour un bot, 12235 pour un autre.

Astuce : Attribuez un operatorId unique à chaque bot ou script afin de suivre facilement qui a envoyé quel ordre.

Voici comment l’intégrer correctement :

Dans votre requête API POST /order (ou d’autres points de terminaison de trading), ajoutez l’operatorId dans le corps (« body ») de la requête.
Assurez-vous de l’envoyer sous forme de nombre (sans guillemets).

✅ Correct : "operatorId": 12234
❌ Incorrect : "operatorId": "12234"

Vérifiez que tous vos points de terminaison API intègrent bien ce paramètre.

Où trouver un exemple ?

Vous pouvez consulter un exemple complet dans la documentation API du point de terminaison « Créer un ordre ».

Voici un exemple simplifié montrant comment utiliser correctement l’operatorId :

{
  "market": "BTC-EUR",
  "side": "buy",
  "orderType": "limit",
  "amount": "0.1",
  "price": "25000",
  "operatorId": 12234
}

L’operatorId doit être inclus dans le corps de la requête, sous forme de nombre entier, sans guillemets. Si ce champ est absent ou mal formaté, l’ordre sera rejeté.

Astuce : Testez vos requêtes API dans l’environnement de test Bitvavo avant de les utiliser en production.

Questions fréquentes

Dois-je utiliser un operatorId différent pour chaque ordre ?

Non. Vous pouvez réutiliser le même operatorId pour tous les ordres émis par un même bot ou script. Ce paramètre sert à distinguer les différents systèmes, pas les ordres individuels.

Que se passe-t-il si j’envoie l’operatorId sous forme de chaîne de caractères ?

L’ordre sera probablement rejeté. L’operatorId doit être transmis sous forme de nombre (int64), sans guillemets.

Existe-t-il une valeur par défaut si je ne définis pas d’operatorId ?

Non. Vous devez toujours définir un operatorId explicitement. Aucune valeur par défaut n’est attribuée automatiquement.

Résumé