Kontoguthaben

Liefert das produktive Guthaben des Energy-Kontos, zu dem die Zugangsdaten gehören.

Anfrage

Es gibt weder Body noch Query. Signieren Sie GET, den Pfad /v1/balance, eine leere Query und einen leeren Body-Hash.

curl https://api.rentron.xyz/v1/balance \
  -H 'Authorization: HMAC-SHA256 {api_key}:{base64_signature}' \
  -H 'X-Request-Timestamp: {unix_seconds}'

Antwort 200

{"available_trx":"120.500000","held_trx":"18.250000","status":"active"}

Feld	Typ	Beschreibung
available_trx	string	Für eine neue Bestellung verfügbares TRX, immer mit sechs Nachkommastellen.
held_trx	string	Durch laufende Bestellungen reserviertes TRX.
status	string	Aktueller Zustand des Kontos, active oder suspended. Das Anlegen einer Bestellung erwartet active und antwortet sonst mit 409 und energy_account_suspended.

Lesen Sie Geldbeträge nie in ein binäres Gleitkommaformat ein. Nutzen Sie den Dezimal- oder Big-Number-Typ Ihrer Plattform.

Fehler

Der Endpunkt kann 401, 429, 500 oder 503 liefern. Halten Sie sich bei 429 an Retry-After; wiederholen Sie 500 und 503 mit wachsendem Abstand.