Zum Inhalt springen

API

Auf dieser Seite

Abrufen

Verfügbare Token-Guthaben abrufen, Beträge je Coin statt je Herkunftsnetzwerk lesen und das Ergebnis vor dem Anlegen einer Auszahlung nutzen.

GET/v1/balances

API-Schlüssel: Payout

Gibt das verfügbare Guthaben des Händlers als eine Gesamtsumme je Coin zurück, über alle Netzwerke summiert — ein Eintrag je Asset. Ein Guthaben ist nicht an ein Netzwerk gebunden; das Netzwerk wählen Sie erst beim Anlegen einer Auszahlung. Guthaben, die sich auf null saldieren, werden weggelassen. Die Umgebung des Schlüssels wählt den Datensatz: Ein Sandbox-Schlüssel liefert Sandbox-Guthaben, ein Live-Schlüssel die echten.

Antwort (200 OK)

[
  { "currency": "USDT", "available": "1750.50" },
  { "currency": "USDC", "available": "500.00" }
]

Felder der Antwort

Die Antwort ist ein Array mit einem Eintrag je Coin — der Gesamtsumme über alle Netzwerke.

Feld Typ Beschreibung
currency Zeichenkette Token-Kürzel — etwa USDT, USDC, DAI
available Zeichenkette Verfügbares Guthaben in den Einheiten des Tokens, über alle Netzwerke summiert, als Dezimalzeichenkette (mit Punkt als Trennzeichen)

Fehler

Guthaben erfordern einen Payout-Schlüssel (rk_) — ein Payment-Schlüssel wird mit 403 payout_key_required abgewiesen. Den vollständigen Katalog finden Sie unter Fehlercodes. Die type-URI in jeder Fehlerantwort verweist direkt auf die passende Zeile.

Abschluss einer Auszahlung simulieren Zahlungskanal erstellen