Эта страница также доступна на английском.
TronEnergyFrog

Разработчикам · REST и x402

API аренды энергии TRON

Три запроса арендуют энергию с вашего бэкенда: POST /v1/quotes/energy фиксирует цену, POST /v1/rental оформляет аренду, а GET /v1/operations/{id} подтверждает доставку. Публичным тарифам ключ не нужен. Боты и ИИ-агенты без аккаунта могут платить за каждую аренду в USDC через x402.

На этой странице
  1. Для кого
  2. API с аккаунтом или x402
  3. Аренда через API с аккаунтом
  4. Публичные тарифы без ключа
  5. x402: оплата в USDC
  6. Отслеживание доставки
  7. Вопросы об API
# 1. Зафиксировать цену на 65 000 энергии на 1 час
curl -X POST https://api.tronenergyfrog.com/v1/quotes/energy \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":65000,"duration_seconds":3600,
       "target_address":"TQ5nW3…8k2Wd"}'
# → { "quote_id": "1111…", "price_trx": "…", … }

# 2. Арендовать. Повторы с тем же ключом никогда не создают вторую аренду.
curl -X POST https://api.tronenergyfrog.com/v1/rental \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Idempotency-Key: payout-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"1111…"}'
# → 202 Accepted · Location: /v1/operations/3333…

# 3. Отследить доставку
curl https://api.tronenergyfrog.com/v1/operations/3333… \
  -H "Authorization: Bearer $TEF_API_KEY"
# → { "status": "succeeded", "txid": "…" }
Сокращённый пример; адреса и ID — условные.Полные схемы в справочнике
Запросов для аренды энергии
3Расчёт, аренда, отслеживание
65K энергии на 1 час сегодня
1,55 TRX≈ 0,47 $ против сжигания 6,50 TRX
Аккаунтов нужно для x402
0Оплата каждой аренды в USDC
Расчёт x402 держит цену
10 минутЦена энергии и курс TRX/USD

Для кого API энергии TRON?

Для всех, кто отправляет USDT в TRON из кода, причём так часто, что 6,50 TRX сжигания за каждый перевод складываются в заметную сумму.

Биржи и кошельки

Арендуйте энергию на горячий кошелёк перед каждой пачкой выводов.

Платёжные системы и выплаты

Одна идемпотентная аренда на выплату с ключом по ID вашей выплаты.

Боты и ИИ-агенты

С x402 аккаунт вообще не нужен: расчёт, оплата в USDC, опрос статуса.

API с аккаунтом или x402: что выбрать?

API с аккаунтомx402
РегистрацияАккаунт с API-ключомНе нужна: без аккаунта и API-ключа
ОплатаПредоплаченный баланс в TRXUSDC в Base (предпочтительно) или Solana, за каждую аренду
Фиксация ценыДо valid_until расчёта10 минут, цена энергии и курс TRX/USD
ОтслеживаниеGET /v1/operations/{id}status_url из расчёта
Лучше всего дляСтабильный объём, единый счётАгенты, разовые скрипты, без хранимого баланса

Как арендовать энергию TRON через API с аккаунтом

  1. Создайте API-ключ

    Войдите через Telegram или Google, откройте раздел API и создайте ключ. Полное значение показывается только один раз. Передавайте его как Authorization: Bearer <key>.

  2. Зафиксируйте цену

    POST /v1/quotes/energy с energy_amount, duration_seconds (3600 или 86400) и target_address — адресом, который будет отправлять USDT. Ответ содержит quote_id, price_trx, valid_until и расчётную экономию по сравнению со сжиганием.

  3. Арендуйте по расчёту

    POST /v1/rental с quote_id и заголовком Idempotency-Key. Средства резервируются на вашем балансе, а аренда ставится в очередь; ответ — 202 с Location операции.

  4. Дождитесь доставки и отправьте USDT

    Опрашивайте операцию до успешного завершения, затем подпишите перевод с целевого адреса.

POST/v1/quotes/energyЗафиксировать цену
POST/v1/rentalАрендовать энергию
GET/v1/operations/{id}Отследить доставку

Свой объёмУстановите custom_amount в true для объёмов, отличных от 65 000 или 130 000. Текущий минимум публикует API; в справочнике указано, где его прочитать.

Цены энергии TRON без ключа

GET https://tronenergyfrog.com/api/v1/rates/energy/default возвращает публичную цену 65 000 энергии на 1 час, количество TRX, которое сожгла бы та же энергия, экономию и почасовую историю. Добавьте ?history=1d, 7d, 30d или 90d. Ответы кешируются на 30 секунд.

Пример ответа · условные значения · average_commission_trx = TRX, сжигаемые без энергии
{
  "energy_amount": 65000,
  "duration_seconds": 3600,
  "price_trx": "2.05",
  "average_commission_trx": "6.5",
  "savings_trx": "4.45",
  "savings_percent": "68.46",
  "network_fee_updated_at": "2026-11-17T12:00:00Z",
  "price_history": {
    "window_hours": 168,
    "median_price_trx": "1.59",
    "current_vs_median_percent": "28.9",
    "points": [ … ]
  }
}

Используйте его для дашбордов и ценовых оповещений. Для заказа всегда запрашивайте расчёт: публичный тариф — это ориентир, а не зафиксированная цена.

x402: аренда энергии TRON за USDC без аккаунта

Не нужны регистрация, аккаунт, API-ключ или предоплаченный баланс. Узнайте актуальный контракт через GET /v1/x402, затем следуйте стандартному процессу x402. Схемы полей описаны в разделе x402 справочника API.

  1. Прочитайте эндпоинт возможностей

    GET /v1/x402 перечисляет текущие эндпоинты и поддерживаемые платёжные сети.

  2. Создайте бесплатный расчёт

    POST /v1/x402/quotes с target_address (и при необходимости energy_amount, duration_seconds). Он фиксирует цену энергии и курс TRX/USD на десять минут.

  3. Получите платёжный запрос

    Отправьте POST на полученный payment_url один раз без подписи. Ответ — 402 Payment Required с PAYMENT-REQUIRED.

  4. Оплатите и повторите

    Оплатите один из предложенных вариантов с кошелька агента и повторите запрос на тот же URL с PAYMENT-SIGNATURE. Успешный расчёт возвращает PAYMENT-RESPONSE.

  5. Опрашивайте status URL

    status_url сообщает и о проведении платежа, и о доставке энергии.

ПриоритетАктивСетьКогда использовать
ПредпочтительноUSDCBaseПервый выбор для совместимых агентов
РезервноUSDCSolanaКогда у агента средства в Solana

Источник истины — ответ 402для идентификаторов сетей, адресов токенов, получателей, срока действия и точной суммы в минимальных единицах. Ботам следует читать ответы API, а не парсить цены с этой страницы.

Как узнать, что энергия доставлена?

Каждая аренда — это операция. Опрашивайте GET /v1/operations/{id}, пока она не перейдёт в финальный статус; успешная операция содержит txid делегирования, который можно открыть в TronScan.

СтатусЧто делать
queued processing submittedПродолжайте опрос. Пока не отправляйте USDT.
succeededЭнергия на целевом адресе. Отправьте перевод, пока аренда активна.
failedПрочитайте error_code. Не отправляйте USDT в расчёте на то, что энергия поступила.
unknownРезультат ещё не подтверждён. Продолжайте опрос; как действовать, описано в справочнике.

Эндпоинты истории и ID проектов для сопоставления операций с вашими заказами описаны в справочнике API.

Вопросы об API

Остались вопросы? Напишите в поддержку — ответит живой человек.

Нужен ли аккаунт, чтобы пользоваться API энергии TRON?

Для API с аккаунтом — да: создайте API-ключ в своём аккаунте. Публичному эндпоинту тарифов и эндпоинтам x402 не нужны ни аккаунт, ни API-ключ.

Как оплачивается аренда через API?

Аренда через API с аккаунтом оплачивается с предоплаченного баланса аккаунта. Аренда через x402 оплачивается каждый раз в USDC в сети Base (предпочтительно) или Solana.

Как не заплатить дважды при повторе запроса?

Передавайте заголовок Idempotency-Key с POST /v1/rental. Повтор запроса с тем же ключом не создаёт вторую аренду.

Какой вариант оплаты x402 выбрать боту?

USDC в Base, если доступен, а USDC в Solana — как резервный. Источник истины для сетей, адресов токенов, получателей, срока действия и точной суммы — ответ 402.

Где полные схемы запросов и ответов?

В справочнике API, который также доступен в форматах OpenAPI JSON и Markdown.

Об этой странице

Эндпоинты и названия полей совпадают с опубликованным справочником API. Код сокращён для удобства чтения; полные схемы и ошибки — в справочнике.

Справочник
api.tronenergyfrog.com/v1/docsтам же ссылки на версии OpenAPI JSON и Markdown
Цены
Публичный API тарифов, 22 нояб. 2026 г., 12:38 UTC
x402
Платёжный процесс x402, USDC в Base и Solana
Проверено
17 ноября 2026 г. · команда TronEnergyFrog

Арендуйте следующие 65K за 1,55 TRX вместо сжигания 6,50 TRX

Сначала попробуйте аренду на сайте, затем автоматизируйте её. Для гостевой аренды аккаунт не нужен, и ничего не списывается до оплаты.

Ваш следующий перевод

Нужно энергии
65 000
Без энергии
Сжигается 6,50 TRX ≈ 1,98 $
С TronEnergyFrog
1,55 TRX ≈ 0,47 $
Остаётся у вас
4,95 TRX ≈ 1,51 $
65K энергии, 1 час1,55 TRX ≈ 0,47 $
Арендовать энергию