Сеть — Справочник API

Вспомогательные методы только для чтения данных сети TRON.

Сгенерировано из openapi.yaml во время сборки. Базовый URL https://api.tenergy.me/v1 или https://api-nile.tenergy.me/v1 в сети Nile (Окружения). Каждый запрос ниже подписывается в соответствии с разделом Аутентификация, если в строке Аутентификация не указано иное.

Состояние ресурсов адреса

GET /v1/resources/{address} · getAddressResources

Аутентификация: Публичный — учетные данные не требуются; запрос с подписью API-ключа (HMAC) также принимается.

Текущая информация сети об адресе: активирован ли он, сколько свободной энергии и пропускной способности доступно, сколько делегировано и кем, а также какие из делегирований созданы нашей платформой.

Читается напрямую с нашей ноды с кратким кэшированием (as_of указывает на время снимка). Используйте этот метод, чтобы определить, требуется ли заказ вообще — самая дешевая энергия — это та, которую вы не покупаете.

Публичный. Учетные данные не обязательны; для анонимных вызовов действует лимит по IP, и поле our_active_orders возвращает []. Подписанный запрос включает активные заказы данного аккаунта на этот адрес и учитывается в бюджете ключа.

Параметры

Ответы

Поля ответа (AddressResources)

Пример ответа 200 из контракта (значения приведены для иллюстрации):

{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "activated": true,
  "balance_sun": 4120000,
  "holds_usdt": true,
  "energy": {"limit":131000,"used":0,"available":131000,"delegated_in":131000},
  "bandwidth": {"limit":1600,"used":0,"available":1600,"delegated_in":0,"free_net_limit":600},
  "our_active_orders": [
    {
      "order_id": "ord_01J9Z5P8T3WQ",
      "amount": 65000,
      "resource": "energy",
      "expires_at": "2026-09-11T19:04:07.900Z"
    }
  ],
  "as_of": "2026-09-11T18:40:00.000Z"
}

Расчет энергии для TRC-20 перевода

POST /v1/estimate/transfer · estimateTransferEnergy

Аутентификация: API-ключ (HMAC).

Сколько энергии потребит TRC-20 перевод с адреса from_address на адрес to_address, и сколько будет стоить аренда этого объема. По умолчанию используется контракт USDT (TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t), если contract_address не указан.

Значение зависит от того, есть ли уже у получателя ненулевой баланс этого токена — перевод новому получателю обходится примерно в два раза дороже — поэтому оба адреса обязательны. Оценка рассчитывается с помощью симуляции triggerConstantContract на нашей ноде, поэтому она отражает актуальное состояние контракта, а не статические таблицы.

Добавьте запас надежности перед заказом: симуляция выполняется сейчас, а транзакция отправляется позже, и баланс получателя может измениться. Поле recommended_amount уже включает платформенный запас и является рекомендуемым объемом для заказа.

Тело запроса

JSON (TransferEstimateRequest), обязательно.

Пример тела запроса из контракта (иллюстративные значения):

{
  "from_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "to_address": "TXXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Ответы

Поля ответа (TransferEstimate)

Пример ответа 200 из контракта (значения приведены для иллюстрации):

{
  "from_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "to_address": "TXXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "recipient_holds_token": false,
  "energy_required": 130285,
  "recommended_amount": 131000,
  "bandwidth_required": 345,
  "tier": "1h",
  "price_sun_per_unit": 20,
  "energy_amount_sun": 2620000,
  "activate_amount_sun": 1200000,
  "total_amount_sun": 3820000,
  "burn_alternative_sun": 13028500,
  "as_of": "2026-09-11T18:41:00.000Z"
}