Если ваше приложение, биржа или бот отправляет USDT (TRC-20) в больших объёмах, покупать энергию вручную неудобно. Официальный TronSave SDK позволяет оценивать, покупать, продлевать и отслеживать заказы энергии прямо из вашего бэкенда — на Node.js, Python, Rust, Java или PHP. Это руководство проведёт вас от установки до первого ончейн-заказа энергии.
Какие есть SDK
Все SDK работают с API v2 и оборачивают одни и те же эндпоинты, поэтому в каждом языке доступны одинаковые операции:
| Язык | Пакет | Установка | Требования |
|---|---|---|---|
| TypeScript / JS | tronsave-sdk |
npm install tronsave-sdk |
Node.js 18+ |
| Python | tronsave |
pip install tronsave |
Python 3.9+ |
| Rust | tronsave |
cargo add tronsave |
— |
| Java | io.tronsave:sdk |
Maven / Gradle | — |
| PHP | tronsave/sdk |
composer require tronsave/sdk |
PHP 8.1+ |
Пакеты для Rust, Python, Java и PHP имеют версию 2.0.0. Для Java координаты — io.tronsave:sdk:2.0.0: добавьте зависимость в pom.xml или в build.gradle как implementation 'io.tronsave:sdk:2.0.0'.
Что умеет каждый SDK
Набор функций намеренно компактный. Какой бы язык вы ни выбрали, вы получаете те же семь операций:
- Estimate Buy Resource — узнать цену покупки до того, как оформить заказ.
- Buy Resource — разместить заказ на энергию или пропускную способность (bandwidth); возвращает ID заказа.
- Get Order / Get Orders — получить статус одного заказа или историю заказов.
- Get Order Book — текущее предложение по ценовым уровням, начиная с самого дешёвого.
- Get User Info — баланс внутреннего счёта и адрес для пополнения.
- Get Extendable Delegates — список делегирований, которые можно продлить.
- Extend Request — продлить существующее делегирование вместо покупки нового заказа.
Последняя пара важнее, чем кажется. Если получателю уже делегирована энергия и нужно лишь, чтобы она действовала дольше, правильный выбор — продление: подробнее в руководстве по функции Extend.
Быстрый старт (Node.js)
Самый быстрый путь — работа через API-ключ: создайте экземпляр SDK, оцените стоимость и разместите заказ. API-ключ можно получить в панели TronSave (см. раздел Аутентификация).
import { TronsaveSDK } from "tronsave-sdk";
const main = async () => {
const sdk = new TronsaveSDK({ network: "mainnet", apiKey: "your_api_key" });
const userInfo = await sdk.getUserInfo();
// Estimate cost for 65,000 ENERGY for 1 hour (one USDT transfer)
const estimate = await sdk.estimateBuyResource({
receiver: "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
resourceType: "ENERGY",
durationSec: 3600,
resourceAmount: 65000,
});
if (estimate.estimateTrx > Number(userInfo.balance)) throw new Error("Insufficient balance");
const { orderId } = await sdk.buyResource({
receiver: "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
resourceType: "ENERGY",
durationSec: 3600,
resourceAmount: 65000,
});
await new Promise((r) => setTimeout(r, 5000)); // wait ~5s to fill
const order = await sdk.getOrder(orderId);
console.log(order.fulfilledPercent < 100 ? "Not filled" : "Filled");
};
main();
Совет: используйте network: "testnet" (Nile), чтобы разрабатывать без реальных TRX, а для продакшена переключитесь на "mainnet".
Две детали, которые стоит знать перед запуском. userInfo.balance возвращается в SUN в виде строки (1 TRX = 1 000 000 SUN), поэтому при сравнении значение приводится к числу. А durationSec — необязательный параметр: если его не указать, заказ по умолчанию действует 259 200 секунд, то есть 3 дня.
Та же задача на Python
Пакет для Python устанавливается командой pip install tronsave и даёт тот же сценарий «оценка → покупка → отслеживание»; сигнатуры методов для каждого языка описаны в справочнике SDK. Если хотите видеть, какие именно HTTP-запросы выполняются под капотом, вот та же задача — оценка, покупка и опрос статуса — напрямую через эндпоинты v2:
import time, requests
API = "https://api.tronsave.io" # testnet: https://api-dev.tronsave.io
HEADERS = {"apikey": "your_api_key", "Content-Type": "application/json"}
ORDER = {
"receiver": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"resourceType": "ENERGY",
"resourceAmount": 65000,
"durationSec": 3600,
"unitPrice": "MEDIUM",
}
estimate = requests.post(f"{API}/v2/estimate-buy-resource", json=ORDER).json()["data"]
print(estimate["estimateTrx"] / 1e6, "TRX", estimate["availableResource"], "available")
order = requests.post(f"{API}/v2/buy-resource", headers=HEADERS,
json={**ORDER, "options": {"allowPartialFill": True,
"maxPriceAccepted": 100}}).json()
order_id = order["data"]["orderId"]
time.sleep(5)
detail = requests.get(f"{API}/v2/order/{order_id}", headers=HEADERS).json()["data"]
print("Filled" if detail["fulfilledPercent"] == 100 else "Not filled")
Те же три шага, те же имена полей, тот же формат ответа. Ценность SDK — в типизации и повторных попытках, а не в каком-то другом API, так что выбирайте то, что удобнее для вашего стека. Более полный скрипт на Python с расчётом объёма по книге заказов и обработкой ошибок — в статье как купить энергию TRON на Python.
Оценка перед покупкой
Запрос оценки заслуживает отдельного абзаца: его ответ сообщает две разные вещи. estimateTrx — стоимость в SUN. availableResource — сколько рынок реально может предоставить прямо сейчас. Если availableResource меньше запрошенного resourceAmount, заказ в этот момент не может быть исполнен полностью, и что делать дальше, вы задаёте через options: allowPartialFill: true — взять то, что есть, или onlyCreateWhenFulfilled: true — отказаться от всего, что меньше полного исполнения. Для ботов с частыми повторами preventDuplicateIncompleteOrders: true не даёт повторному вызову плодить одинаковые открытые заказы.
Ошибки и лимиты
Эндпоинты допускают 15 запросов в секунду; при превышении возвращается HTTP 429 с "Rate limit reached", и достаточно простого backoff 1 с/2 с/4 с. Ошибки приложения приходят как error: true с машиночитаемым кодом внутри message — INVALID_API_KEY, INTERNAL_BALANCE_ACCOUNT_TOO_LOW, PRICE_EXCEED_MAX_PRICE_REQUIRED, CANNOT_FULFILLED. Ветвите логику по коду: формулировка текста может измениться.
Управление TronSave из ИИ-агента
Если ваша интеграция — это агент, а не сервис, TronSave также предоставляет MCP-сервер по адресу https://mcp.tronsave.io/mcp через Streamable HTTP (и https://mcp.tronsave.io/testnet/mcp для тестовой сети). Он предоставляет 53 MCP-инструмента (версия сервера 1.3.0, ноябрь 2026 г.) — tronsave_estimate_buy_resource, tronsave_list_order_books, tronsave_internal_order_create и другие — с сессиями по API-ключу или по подписи кошелька. Подключите к эндпоинту любой MCP-совместимый клиент; наше руководство по MCP-серверу TronSave описывает вход, два семейства инструментов и модель безопасности.
Предпочитаете чистый HTTP? SDK оборачивают те же эндпоинты API — см. наше руководство по автоматизации через API, разбор типов заказов TronSave и, для больших объёмов, оптовую покупку энергии.
FAQ
Нужен ли API-ключ?
Работа через API-ключ — самый простой вариант; также можно подписывать транзакции приватным ключом. Ключ можно получить в панели. Разница — в хранении средств: API-ключ тратит средства с заранее пополненного внутреннего счёта TronSave, а сценарий с подписанными транзакциями оплачивает каждую покупку из вашего собственного кошелька и требует TronWeb.
Какие языки поддерживаются?
Node.js/TypeScript, Python, Rust, Java и PHP — все на API v2. Отдельные пошаговые руководства есть для Python, Java, PHP и Rust.
Сколько энергии нужно на перевод USDT?
Около 65 000 (≈130 000, если у получателя никогда не было USDT). Подробнее — в статье сколько энергии нужно для перевода USDT.
Можно ли тестировать, не тратя реальные TRX?
Да. Укажите network: "testnet" (или направьте базовый URL на https://api-dev.tronsave.io), чтобы работать с Nile. Ключи, балансы и заказы в каждой среде свои, поэтому создайте ключ для Nile на testnet.tronsave.io — ключ от mainnet будет отклонён. Shasta не поддерживается.
Начните разработку: изучите документацию TronSave и получите API-ключ в панели маркета.
Пишете на Python? Смотрите отдельное руководство: как купить энергию TRON на Python (полный рабочий скрипт).


