# API аренды энергии TRON для ботов | TEnergy

Source: https://tenergy.me/ru/learn/energy-api-for-bots

1.  [TEnergy](/ru)
2.  [Обучение](/ru/learn)
3.  API аренды энергии TRON для ботов и бэкенд-сервисов

# API аренды энергии TRON для ботов и бэкенд-сервисов

Как подключить аренду энергии TRON к Telegram-боту или платёжному бэкенду: 5 шагов REST API — оценка, подпись HMAC, котировка, заказ и вебхуки.

Опубликовано 2 октября 2026 г. · Обновлено 3 октября 2026 г.

Автоматическая аренда энергии TRON позволяет Telegram-ботам, платёжным процессорам и сервисам автоматических выплат отправлять USDT TRC20 без ручного управления стейкингом TRX и без сжигания TRX на газ. Вместо того чтобы строить собственную инфраструктуру стейкинга или замораживать оборотные средства на 14 дней, разработчики ботов подключаются к REST API, который по запросу делегирует энергию в сети через Stake 2.0[\[3\]](#source-3).

Подключение проходит пять шагов жизненного цикла[\[1\]](#source-1): мгновенная оценка стоимости, подпись запросов HMAC-SHA256[\[2\]](#source-2), котировка с фиксированной на 120 секунд ценой, идемпотентный заказ с собственным `client_order_id` и подтверждение делегирования через подписанные вебхуки.

Прежде чем запускать автоматические заказы в продакшене, проверьте подпись, создание заказов и обработку вебхуков вашего бота в нашем окружении на тестовой сети Nile (`https://api-nile.tenergy.me/v1`).

## Пять шагов подключения бота

Наш REST API даёт предсказуемый порядок работы, рассчитанный на автоматические бэкенды:

```
[Bot / Server]                      [Energy API]                      [TRON Chain]
       |                                   |                                |
       |--- 1. GET /v1/estimate ---------->|                                |
       |<-- Returns total SUN & price -----|                                |
       |                                   |                                |
       |--- 2. POST /v1/quotes ----------->|                                |
       |<-- Returns quote_id (120s lock) --|                                |
       |                                   |                                |
       |--- 3. POST /v1/orders ----------->|                                |
       |<-- 201 Created (ord_...) ---------|--- delegateResource ---------->|
       |                                   |                                |
       |<-- 4. Webhook: order.confirmed ---|<-- Confirmed in block ---------|
       |                                   |                                |
       |--- 5. Broadcast USDT transfer ------------------------------------>|
```

### 1\. Оценка стоимости заказа без ключей

Чтобы показать пользователям бота цену сразу или рассчитать комиссию за перевод, запросите `GET /v1/estimate`[\[1\]](#source-1). Этот публичный эндпоинт не требует API-ключа:

bash

```bash
curl -sG https://api.tenergy.me/v1/estimate \
  -d resource=energy -d amount=65000 -d tier=1h \
  -d receiver=TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE
```

В ответе приходят `total_amount_sun`, `price_sun_per_unit` и признак того, активирован ли кошелёк получателя в сети.

### 2\. Подпись запросов HMAC-SHA256

Все эндпоинты с аутентификацией требуют трёх HTTP-заголовков[\[2\]](#source-2):

-   `X-API-KEY`: идентификатор вашего ключа (`ak_live_...` или `ak_test_...`).
-   `X-API-TIMESTAMP`: метка времени ISO 8601 в UTC (допуск 5 секунд).
-   `X-API-SIGN`: `base64(HMAC-SHA256(secret, timestamp + METHOD + path + query + body))`.

### 3\. Фиксация цены котировкой на 120 секунд

Чтобы цена не изменилась, пока пользователь общается с ботом, вызовите `POST /v1/quotes`[\[1\]](#source-1). Котировка фиксирует итоговую стоимость на 120 секунд:

json

```json
{
  "resource": "energy",
  "amount": 65000,
  "tier": "1h",
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}
```

### 4\. Идемпотентный заказ

Передайте `quote_id` и свой `client_order_id` в `POST /v1/orders`[\[1\]](#source-1). Если соединение прервалось или запрос завершился по таймауту, повторите тот же вызов: система определяет client order ID и возвращает существующий заказ без повторного списания.

json

```json
{
  "quote_id": "qt_01J9Z5NB2K4R",
  "client_order_id": "bot-order-94812"
}
```

### 5\. Подтверждение делегирования в сети

Перед отправкой перевода USDT бот должен дождаться подтверждения:

-   **Вебхуки:** укажите HTTPS-адрес в личном кабинете. Когда делегирование подтверждено в сети, система присылает событие `order.confirmed`, подписанное HMAC-SHA256[\[2\]](#source-2).
-   **Опрос:** как запасной вариант опрашивайте `GET /v1/orders/cid:bot-order-94812` каждые 1–2 секунды, пока `status` не станет `active` после `delegateResource` в сети[\[3\]](#source-3).

## Эндпоинты API

| Эндпоинт | Метод | Аутентификация | Назначение |
| --- | --- | --- | --- |
| `/v1/estimate` | `GET` | Нет | Публичная оценка стоимости для заданного объёма энергии и получателя |
| `/v1/prices` | `GET` | Нет | Текущая сетка цен по времени суток и доступные сроки аренды |
| `/v1/balance` | `GET` | Да | Доступный баланс аккаунта в SUN |
| `/v1/quotes` | `POST` | Да | Фиксирует цену на 120 секунд (`quote_id`) |
| `/v1/orders` | `POST` | Да | Создаёт заказ энергии с защитой идемпотентностью |
| `/v1/orders/cid:{id}` | `GET` | Да | Статус заказа по внутреннему идентификатору вашего бота |

## Практики архитектуры для разработчиков ботов

1.  **Раздельные окружения:** разрабатывайте и отлаживайте сценарии бота на нашем эндпоинте тестовой сети Nile (`https://api-nile.tenergy.me/v1`). Тестовые ключи имеют префикс `ak_test_` и полностью изолированы от рабочих аккаунтов.
2.  **Ключ идемпотентности на каждый заказ:** генерируйте отдельный `client_order_id` для каждого уникального действия пользователя. Это исключает случайное двойное списание при сетевых сбоях.
3.  **Проверка частичного исполнения:** смотрите булево поле `partial` в записи заказа. Если предложения не хватает, заказ может исполниться частично; остаток возвращается автоматически.
4.  **Отправка после подтверждения:** дождитесь вебхука `order.confirmed` или статуса `active`, прежде чем отправлять зависящую от него транзакцию USDT TRC20 в мейннете TRON.

Технические подробности — в полном [руководстве Quickstart](/ru/docs/quickstart), [справочнике по аутентификации](/ru/docs/authentication) и [документации API](/ru/api).

## Источники

1.  [Спецификация API TEnergy: Quickstart и жизненный цикл заказа](https://tenergy.me/docs/quickstart) [↩](#cite-ref-1 "Вернуться к тексту")
2.  [Спецификация API TEnergy: аутентификация HMAC-SHA256](https://tenergy.me/docs/authentication) [↩](#cite-ref-2 "Вернуться к тексту")
3.  [Руководство разработчика TRON по Stake 2.0 (delegateResource)](https://developers.tron.network/docs/stake-20) [↩](#cite-ref-3 "Вернуться к тексту")
4.  [Контракт Tether USD (USDT) TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t на Tronscan](https://tronscan.org/#/contract/TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t) [↩](#cite-ref-4 "Вернуться к тексту")

## Вопросы и ответы

01

### Как бот может автоматически арендовать энергию TRON?

Бэкенд бота обращается к REST API в пять шагов: запрашивает публичную оценку, подписывает запрос HMAC-SHA256, фиксирует цену котировкой, отправляет идемпотентный заказ и ждёт вебхука о подтверждении.

02

### Нужен ли боту API-ключ, чтобы узнать текущие цены на энергию?

Нет. Эндпоинты GET /v1/estimate и GET /v1/prices публичные и не требуют ни заголовков аутентификации, ни API-ключа.

03

### Как API защищает от дублей заказа, если запрос бота отвалился по таймауту?

Заказ принимает уникальный client\_order\_id. Если случился сетевой таймаут и бот повторяет тот же запрос, API возвращает исходный заказ со статусом 200 и не списывает деньги второй раз.

04

### Что лучше для бота: опрашивать статус заказа или принимать вебхуки?

Для серверов с публичным HTTPS-адресом рекомендуются вебхуки с проверкой криптографической подписи. Как запасной вариант для локального запуска поддерживается опрос GET /v1/orders/cid:{client\_order\_id}.

Не нашли ответа? Напишите нам в Telegram [@tenergymebot](https://t.me/tenergymebot) или на [support@tenergy.me](mailto:support@tenergy.me), и мы добавим ответ сюда.
