модель THENERGY APIформат REST · JSONRU · EN · 中文← на главную

Документация API

Аренда энергии TRON за баланс Telegram-бота
Энергия действует 60 минут после выдачи.

01 — старт

Заберите ключ в боте: кнопка 🔑 API → «Создать ключ». Строка вида trn_… показывается один раз — скопируйте её сразу.
Подписывайте запросы заголовком X-API-Key: trn_… или Authorization: Bearer trn_….

Оплата — с баланса бота. Лимит: 30 запросов в минуту на ключ.

02 — эндпоинты

POST/v1/energy/rent

Арендовать энергию на адрес.

Поле	Что слать
`address`	TRON-адрес получателя, начинается с T, 34 символа
`energy`	Только `65000` · `66000` · `131000`. Цена: 100 / 110 / 200 RUB
`client_key`	Необязательно. Своя метка заказа: повтор запроса с той же меткой вернёт уже созданный заказ без нового списания. Так безопасно нажать «повторить»

Успех — 200. Пример ответа:

{"order_id": "7514cf6659a8ff19fe8105d63a8c994e",
  "address": "T...",
  "energy": 65000,
  "cost": 100,
  "balance": 400.0}

GET/v1/balance

Баланс бота, привязанный к ключу. Проверка «ключ работает?» — тоже сюда.

{"user_id": 123456,
  "balance": 1240.5}

GET/v1/orders?limit=20

Последние заказы, от 1 до 100 штук.

{"orders": [
    {"order_id": "7514cf6659a8ff19fe8105d63a8c994e",
     "energy": 65000,
     "cost": 100,
     "date": "2026-10-09T12:00:00",
     "source": "api"}
  ]}

GET/v1/prices

Пакеты и цены.

{"currency": "RUB",
  "duration": "1h",
  "prices": [
    {"energy": 65000, "cost": 100},
    {"energy": 66000, "cost": 110},
    {"energy": 131000, "cost": 200}
  ]}

03 — ошибки

Код	Что случилось и что делать
`401`	Ключ не прислали или он чужой. Проверьте заголовок целиком — пробелы по краям тоже считаются
`402`	Не хватило баланса. В ответе поля `need` и `balance` — пополните разницу в боте
`403`	Ключ отозван, запрос с чужого IP или пользователь забанен
`422`	Нет такого пакета, кривой адрес либо адрес не активирован в сети TRON
`429`	Лимит исчерпан. Подождите минуту
`502`	Не удалось отправить энергию. Деньги не списаны — повторите позже с тем же `client_key`

04 — консоль

Шлёт настоящие запросы на ….

Ключ Запрос

05 — примеры

curl — аренда:

curl -X POST https://api.thenergy.xyz/v1/energy/rent   -H "X-API-Key: trn_..." -H "Content-Type: application/json"   -d '{"address":"T...","energy":65000,"client_key":"order-1"}'

Python:

import requests

BASE = "https://api.thenergy.xyz"
HEADERS = {"X-API-Key": "trn_..."}  # ключ из бота: кнопка API

# баланс
print(requests.get(BASE + "/v1/balance", headers=HEADERS).json())

# аренда энергии
payload = {
    "address": "T...",
    "energy": 65000,
    "client_key": "order-1",  # необязательное поле
}
r = requests.post(BASE + "/v1/energy/rent", headers=HEADERS, json=payload)
print(r.status_code, r.json())