---
title: "Как купить энергию TRON через код: TronSave SDK (Node.js, Python и другие)"
description: "Покупайте энергию TRON программно через TronSave SDK для Node.js, Python, Rust, Java и PHP: оценка, покупка и отслеживание заказов из бэкенда."
url: https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-kod-tronsave-sdk/
canonical: https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-kod-tronsave-sdk/
lang: ru-RU
datePublished: 2026-11-15T11:31:46+00:00
dateModified: 2026-11-15T11:31:46+00:00
author: TronSave
publisher: TronSave (https://tronsave.io/)
categories:
  - Руководства по TRON
keywords: sdk энергия tron
translations:
  en: https://blog.tronsave.io/buy-tron-energy-with-code-tronsave-sdk/
  es: https://blog.tronsave.io/es/comprar-energia-tron-con-codigo-sdk-tronsave/
  pt: https://blog.tronsave.io/pt/comprar-energia-tron-com-codigo-sdk-tronsave/
  zh: https://blog.tronsave.io/zh/tronsave-sdk-daima-goumai-bochang-nengliang/
  de: https://blog.tronsave.io/de/tron-energie-per-code-kaufen-tronsave-sdk/
---

# Как купить энергию TRON через код: TronSave SDK (Node.js, Python и другие)

Если ваше приложение, биржа или бот отправляет 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](https://blog.tronsave.io/ru/funkciya-extend-prodlenie-arendy-energii-tron/).

## Быстрый старт (Node.js)

Самый быстрый путь — работа через API-ключ: создайте экземпляр SDK, оцените стоимость и разместите заказ. API-ключ можно получить в [панели TronSave](https://tronsave.io/ru/market) (см. раздел [Аутентификация](https://docs.tronsave.io/developers/authentication)).

```
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](https://docs.tronsave.io/developers/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](https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-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](https://blog.tronsave.io/tronsave-mcp-server-ai-agent-tron-energy/) описывает вход, два семейства инструментов и модель безопасности.

Предпочитаете чистый HTTP? SDK оборачивают те же эндпоинты [API](https://api.tronsave.io) — см. наше [руководство по автоматизации через API](https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-api/), разбор [типов заказов TronSave](https://blog.tronsave.io/ru/tipy-zakazov-tronsave/) и, для больших объёмов, [оптовую покупку энергии](https://blog.tronsave.io/ru/kupit-energiyu-tron-optom-dlya-perevodov-usdt/).

## FAQ

**Нужен ли API-ключ?**  
Работа через API-ключ — самый простой вариант; также можно подписывать транзакции приватным ключом. Ключ можно получить в [панели](https://tronsave.io/ru/market). Разница — в хранении средств: API-ключ тратит средства с заранее пополненного внутреннего счёта TronSave, а сценарий с подписанными транзакциями оплачивает каждую покупку из вашего собственного кошелька и требует TronWeb.

**Какие языки поддерживаются?**  
Node.js/TypeScript, Python, Rust, Java и PHP — все на API v2. Отдельные пошаговые руководства есть для [Python](https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-python/), [Java](https://blog.tronsave.io/how-to-buy-tron-energy-in-java-sdk-guide/), [PHP](https://blog.tronsave.io/how-to-buy-tron-energy-in-php-sdk-guide/) и [Rust](https://blog.tronsave.io/how-to-buy-tron-energy-in-rust-sdk-guide/).

**Сколько энергии нужно на перевод USDT?**  
Около 65 000 (≈130 000, если у получателя никогда не было USDT). Подробнее — в статье [сколько энергии нужно для перевода USDT](https://blog.tronsave.io/ru/skolko-energii-nuzhno-dlya-perevoda-usdt/).

**Можно ли тестировать, не тратя реальные TRX?**  
Да. Укажите `network: "testnet"` (или направьте базовый URL на `https://api-dev.tronsave.io`), чтобы работать с Nile. Ключи, балансы и заказы в каждой среде свои, поэтому создайте ключ для Nile на `testnet.tronsave.io` — ключ от mainnet будет отклонён. Shasta не поддерживается.

**Начните разработку:** изучите [документацию TronSave](https://docs.tronsave.io) и получите API-ключ в [панели маркета](https://tronsave.io/ru/market).

**Пишете на Python?** Смотрите отдельное руководство: [как купить энергию TRON на Python](https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-python/) (полный рабочий скрипт).
