Account balance

Returns the production balance for the Energy account associated with the API credential.

Request

There is no body or query. Sign GET, path /v1/balance, an empty query, and an empty body hash.

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

Response 200

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

Field	Type	Description
available_trx	string	TRX available for a new order, always six decimals.
held_trx	string	TRX reserved by active orders.
status	string	Current account state. Order creation expects active.

Do not parse money with binary floating point. Use your platform's decimal or big-number type.

Errors

The endpoint can return 401, 429, or 503. Respect Retry-After on 429; retry 503 with backoff.