API de producción
Saldo de la cuenta
Consulta los TRX disponibles y retenidos antes de crear un pedido.
GET
/v1/balanceEn esta página
Devuelve el saldo de producción de la cuenta de Energy asociada a la credencial de API.
Petición
No lleva cuerpo ni cadena de consulta. Firma GET, la ruta /v1/balance, una consulta vacía y un hash de cuerpo vacío.
curl https://api.rentron.xyz/v1/balance \
-H 'Authorization: HMAC-SHA256 {api_key}:{base64_signature}' \
-H 'X-Request-Timestamp: {unix_seconds}'
Respuesta 200
{"available_trx":"120.500000","held_trx":"18.250000","status":"active"}
| Campo | Tipo | Descripción |
|---|---|---|
available_trx |
cadena | TRX disponibles para un pedido nuevo, siempre con seis decimales. |
held_trx |
cadena | TRX reservados por pedidos activos. |
status |
cadena | Estado actual de la cuenta, active o suspended. La creación de pedidos espera active; en cualquier otro caso responde 409 con energy_account_suspended. |
No manejes importes con coma flotante binaria. Usa el tipo decimal o de precisión arbitraria de tu plataforma.
Errores
El endpoint puede devolver 401, 429, 500 o 503. Respeta Retry-After en un 429; reintenta los 500 y los 503 con espera creciente.
Rentron