Was ist die operatorId und warum ist sie erforderlich? – Bitvavo Hilfezentrum

Zusammenfassung

Dieser Artikel erklärt, was die operatorId ist, warum sie aufgrund gesetzlicher Anforderungen verpflichtend ist und wie Sie sie korrekt beim Platzieren von API-Orders über Bitvavo verwenden. Wenn Sie mehrere Bots oder Skripte nutzen, um über die API zu handeln, zeigt dieser Artikel, wie Sie die operatorId richtig im Anfrage-Body angeben.

Was ist die operatorId?

Die operatorId ist ein verpflichtender Parameter bei API-Anfragen, die Handelsaktionen betreffen – zum Beispiel das Erstellen einer Order. Sie wurde im Rahmen gesetzlicher Vorgaben eingeführt und dient dazu, innerhalb eines Accounts nachvollziehen zu können, welches System, Skript oder welcher Bot eine bestimmte Order gesendet hat.

Es handelt sich um eine Ganzzahl vom Typ int64, die nicht von Bitvavo vorgegeben wird. Sie legen den Wert selbst fest. Wir empfehlen eine Zahl im Bereich von 1 bis 9.223.372.036.854.775.807.

Wenn Sie mehrere Bots oder Skripte unter einer API verwenden, können Sie mit der operatorId eindeutig zuordnen, von welchem System eine Order stammt.

Warum ist die operatorId verpflichtend?

Aufgrund neuer Krypto-Regulierungen müssen Anbieter wie Bitvavo sicherstellen, dass Handelsaktivitäten eindeutig rückverfolgbar sind. Die operatorId erfüllt dabei folgende Zwecke:

Identifiziert eindeutig, welches System eine Order im Account gesendet hat
Ist bei jeder Handelsanfrage über die API erforderlich
Kann nicht weggelassen oder deaktiviert werden
Muss pro Bot oder Skript im Account eindeutig sein

So verwenden Sie die operatorId

Die operatorId ist ein Ganzzahlwert (int64). Sie vergeben diesen selbst. Zum Beispiel: 12234 für Bot A und 12235 für Bot B.

Tipp: Verwenden Sie für jedes Skript oder jeden Bot eine eindeutige operatorId, um Aktivitäten sauber voneinander abzugrenzen.

So integrieren Sie die operatorId korrekt:

Fügen Sie die operatorId bei allen relevanten API-Endpunkten (z. B. POST /order) im Body des Requests hinzu.
Übermitteln Sie sie als Zahl, nicht als Zeichenkette (also ohne Anführungszeichen).

✅ Korrekt: "operatorId": 12234
❌ Falsch:  "operatorId": "12234"

Stellen Sie sicher, dass alle Ihre API-Requests diesen Parameter korrekt übermitteln.

Wo finde ich ein Beispiel?

Ein vollständiges Beispiel finden Sie in unserer API-Dokumentation zum Endpunkt „Order erstellen“.

Ein einfaches Beispiel für die korrekte Einbindung:

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

Die operatorId muss im Body der Anfrage enthalten sein und als Ganzzahl (ohne Anführungszeichen) übermittelt werden. Andernfalls wird die Order abgelehnt.

Tipp: Testen Sie Ihre API-Requests zunächst in der Bitvavo-Testumgebung, um Fehler in der Live-Umgebung zu vermeiden.

Häufig gestellte Fragen

Muss ich für jede Order eine andere operatorId verwenden?

Nein. Sie können dieselbe operatorId für alle Orders eines bestimmten Bots oder Skripts wiederverwenden. Wichtig ist nur, dass jede Anwendung eine eigene ID hat.

Was passiert, wenn ich die operatorId als Zeichenkette sende?

Die Order wird in diesem Fall höchstwahrscheinlich abgelehnt. Achten Sie darauf, die operatorId als Ganzzahl (int64) und nicht in Anführungszeichen zu übermitteln.

Gibt es eine Standard-operatorId, wenn ich keine setze?

Nein. Sie müssen immer selbst eine gültige operatorId definieren. Es gibt keinen automatischen Fallback-Wert.

Zusammenfassung