Документация для разработчиков

Пространство API
https://api.rentron.xyz/v1
Схема OpenAPI

Баланс

// GET

API для реальных заказов

Баланс аккаунта

Прочитайте доступный и удержанный баланс TRX перед созданием заказа.

GET /v1/balance
На этой странице

Возвращает баланс Energy-аккаунта, связанного с API-ключом.

Запрос

У метода нет тела и параметров запроса. Подпишите GET, путь /v1/balance, пустую строку параметров и хеш пустого тела.

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

Ответ 200

{"available_trx":"120.500000","held_trx":"18.250000","status":"active"}
Поле Тип Описание
available_trx string TRX, доступные для нового заказа. Всегда 6 знаков после точки.
held_trx string TRX, удержанные активными заказами.
status string Текущее состояние аккаунта. Для создания заказов ожидайте active.

Не суммируйте денежные строки как числа с плавающей запятой. Используйте тип с точной десятичной арифметикой, который предоставляет ваша платформа.

Ошибки

Метод может вернуть 401, 429 или 503. При 429 соблюдайте Retry-After; после 503 повторите запрос с увеличивающейся паузой.