Wat is de operatorId en waarom is deze verplicht? – Bitvavo Helpcentrum

Samenvatting

In dit artikel lees je wat de operatorId is, waarom deze verplicht is volgens regelgeving en hoe je dit veld correct gebruikt wanneer je API-orders plaatst via Bitvavo. Gebruik je meerdere bots of scripts om te handelen via de API? Dan helpt dit artikel je om de operatorId goed in te stellen in je verzoek.

Wat is de operatorId?

De operatorId is een verplicht veld voor API-verzoeken waarmee je een order plaatst. Dit is ingevoerd vanwege cryptoregelgeving en zorgt ervoor dat je kunt zien welk script of welke bot binnen jouw account een order heeft geplaatst.

Het is een integer (geheel getal) en wordt niet door Bitvavo geleverd. Je kiest dit getal zelf. We raden een waarde aan tussen 1 en 9.223.372.036.854.775.807.

Gebruik je meerdere bots of scripts onder één API-sleutel? Dan kun je met de operatorId achterhalen welke bot welke order heeft verstuurd.

Waarom is dit verplicht?

Vanwege nieuwe wetgeving moeten platformen zoals Bitvavo zorgen voor meer transparantie in handelsactiviteiten. De operatorId helpt hierbij:

Je ziet wie of wat een order heeft geplaatst binnen jouw account
Het veld is verplicht bij elke order via de API
Je kunt dit veld niet weglaten of uitschakelen
Elke bot of systeem binnen je account krijgt een uniek geheel getal

Hoe gebruik je de operatorId?

De operatorId is een int64 (geheel getal). Je stelt dit zelf in. Bijvoorbeeld: gebruik 12234 voor bot A en 12235 voor bot B.

Tip: Geef elke bot of script een unieke operatorId zodat je precies weet welke component de order heeft verzonden.

Zo stel je het correct in:

Gebruik je de POST /order API-call (of andere handelsendpoints)? Voeg dan de operatorId toe aan de body van het verzoek.
Zorg dat je het verzendt als een getal, niet als tekst (geen aanhalingstekens).

✅ Correct: "operatorId": 12234
❌ Fout: "operatorId": "12234"

Controleer of al je API-endpoints de operatorId bevatten.

Waar vind ik voorbeelden?

Bekijk ons API-document voor het aanmaken van een order voor een volledig voorbeeld.

Hieronder zie je een vereenvoudigd voorbeeld waarin de operatorId correct wordt gebruikt:

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

Zorg dat de operatorId in de body van het verzoek staat en als getal wordt verzonden (zonder aanhalingstekens). Wordt dit fout verzonden, dan wordt je order afgewezen.

Tip: Test je API-verzoeken eerst in de Bitvavo testomgeving om fouten in productie te voorkomen.

Veelgestelde vragen

Moet ik voor elke order een andere operatorId gebruiken?

Nee, je kunt dezelfde operatorId hergebruiken voor alle orders van dezelfde bot of script. Het doel is om verschillende systemen van elkaar te onderscheiden, niet individuele transacties.

Wat gebeurt er als ik de operatorId als tekst verstuur?

De order wordt waarschijnlijk afgewezen. Zorg ervoor dat je de operatorId als getal (int64) verstuurt, dus zonder aanhalingstekens.

Is er een standaard operatorId als ik er geen instel?

Nee, je moet altijd zelf een operatorId instellen. Er is geen standaardwaarde.

Samenvatting