Documentación para desarrolladores

Espacio de trabajo de la API
https://api.rentron.xyz/v1
Esquema OpenAPI

Saldo

// GET

API de producción

Saldo de la cuenta

Consulta los TRX disponibles y retenidos antes de crear un pedido.

GET /v1/balance
En 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.