---
title: Как купить энергию TRON на Python (TronSave API, 2026)
description: "Покупка энергии TRON на Python через TronSave API: готовый пример — проверка баланса, заказ энергии и опрос статуса до её получения."
url: https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-python/
canonical: https://blog.tronsave.io/ru/kak-kupit-energiyu-tron-na-python/
lang: ru-RU
datePublished: 2026-11-15T11:22:06+00:00
dateModified: 2026-11-15T11:22:06+00:00
author: TronSave
publisher: TronSave (https://tronsave.io/)
categories:
  - Руководства по TRON
keywords: купить энергию tron python,энергия tron api python
translations:
  en: https://blog.tronsave.io/how-to-buy-tron-energy-in-python/
  es: https://blog.tronsave.io/es/comprar-energia-tron-python-api/
  pt: https://blog.tronsave.io/pt/comprar-energia-tron-com-python/
  zh: https://blog.tronsave.io/zh/python-goumai-bochang-nengliang/
  de: https://blog.tronsave.io/de/tron-energie-mit-python-kaufen/
---

# Как купить энергию TRON на Python (TronSave API, 2026)

Если ваш бэкенд на Python отправляет USDT (TRC-20) — бот, биржа, платёжный сервис, — удобнее **покупать [энергию TRON](https://blog.tronsave.io/ru/energiya-i-propusknaya-sposobnost-tron/) на Python** автоматически, а не вручную. Ниже — полный рабочий пример на TronSave API: скрипт проверяет баланс, размещает заказ на энергию и опрашивает статус, пока энергия не будет доставлена.

## Перед началом

-   Получите **API-ключ** в [панели TronSave](https://tronsave.io/ru/market) (он списывает средства с вашего внутреннего баланса TronSave — никогда не раскрывайте его на стороне клиента).
-   Установите HTTP-клиент: `pip install requests`. Нужна типизированная обёртка? Используйте официальный SDK: `pip install tronsave` — подробнее в [обзоре SDK](https://blog.tronsave.io/buy-tron-energy-with-code-tronsave-sdk/).
-   Пополните внутренний аккаунт. Минимальный депозит — **10 TRX** за транзакцию, а для первого депозита нужен примерно **1 TRX сверху** на активацию нового адреса. Баланс обновляется примерно за 3 секунды.

## Эндпоинты

Скрипт использует четыре эндпоинта v2 с аутентификацией через заголовок `apikey`:

-   `GET /v2/user-info` — баланс вашего внутреннего аккаунта.
-   `GET /v2/order-book` — доступная ликвидность и цены.
-   `POST /v2/buy-resource` — размещение заказа, возвращает `orderId`.
-   `GET /v2/order/{orderId}` — опрос, пока `fulfilledPercent` не достигнет 100.

Для каждого действует лимит **15 запросов в секунду**. Каждый возвращает одинаковую обёртку: `error`, `message` и объект `data`. Напишите разбор ответа один раз — и он подойдёт везде.

## Полный пример на Python

```
import time, requests

API_KEY = "your_api_key"
TRONSAVE_API_URL = "https://api.tronsave.io"   # testnet: https://api-dev.tronsave.io
RECEIVER_ADDRESS = "your_receiver_address"
BUY_AMOUNT = 65000          # ~1 USDT (TRC-20) transfer
DURATION = 3600             # rental duration, in seconds (1 hour)
MAX_PRICE_ACCEPTED = 100    # max price in SUN per unit
RESOURCE_TYPE = "ENERGY"    # ENERGY or BANDWIDTH

HEADERS = {"apikey": API_KEY}

def get_account_info():
    return requests.get(f"{TRONSAVE_API_URL}/v2/user-info", headers=HEADERS).json()

def get_order_book():
    return requests.get(f"{TRONSAVE_API_URL}/v2/order-book",
                        headers=HEADERS,
                        params={"address": RECEIVER_ADDRESS}).json()

def buy_resource():
    body = {
        "resourceType": RESOURCE_TYPE,
        "unitPrice": "MEDIUM",          # a price in SUN, or SLOW / MEDIUM / FAST
        "resourceAmount": BUY_AMOUNT,
        "receiver": RECEIVER_ADDRESS,
        "durationSec": DURATION,
        "options": {
            "allowPartialFill": True,
            "maxPriceAccepted": MAX_PRICE_ACCEPTED,
            "preventDuplicateIncompleteOrders": True,
        },
    }
    return requests.post(f"{TRONSAVE_API_URL}/v2/buy-resource",
                         headers={**HEADERS, "Content-Type": "application/json"},
                         json=body).json()

def get_order(order_id):
    return requests.get(f"{TRONSAVE_API_URL}/v2/order/{order_id}", headers=HEADERS).json()

def main():
    print(get_order_book()["data"])      # [{"price": 54, "availableResourceAmount": 2403704}, ...]

    balance = int(get_account_info()["data"]["balance"])
    if balance < MAX_PRICE_ACCEPTED * BUY_AMOUNT:
        raise SystemExit("Insufficient TronSave balance")

    order = buy_resource()
    if order["error"]:
        raise SystemExit(f"Buy failed: {order['message']}")

    order_id = order["data"]["orderId"]
    while True:                          # poll until the energy is delivered
        time.sleep(3)
        detail = get_order(order_id)["data"]
        if detail["fulfilledPercent"] == 100 or detail["remainAmount"] == 0:
            print(f"Energy delivered - paid {detail['payoutAmount'] / 1e6} TRX")
            for d in detail["delegates"]:
                print(d["delegator"], d["amount"], d["txid"])
            break
        print(f"Waiting for fill... {detail['fulfilledPercent']}%")

if __name__ == "__main__":
    main()
```

## Как это работает

1.  **Сначала изучите рынок.** `get_order_book()` возвращает список уровней `{price, availableResourceAmount}` — от самого дешёвого предложения. Если вам нужно 500 000 энергии, а на двух самых дешёвых уровнях вместе только 300 000, цену исполнения определит третий уровень. Именно поэтому жёстко заданный низкий `maxPriceAccepted` в загруженные дни молча не срабатывает.
2.  **Проверьте баланс.** `get_account_info()` возвращает `balance`, `depositAddress` и `representAddress` — суммы в **SUN** и в виде строки, поэтому приводите тип. 1 TRX = 1 000 000 SUN. Значение `"50000000"` — это 50 TRX.
3.  **Разместите заказ.** `buy_resource()` отправляет запрос на `/v2/buy-resource`. Укажите `API_KEY`, `RECEIVER_ADDRESS` и объём энергии — **65 000** хватает на один перевод USDT, примерно **130 000** — для получателя, который ещё ни разу не получал USDT (см. [сколько энергии нужно для перевода USDT](https://blog.tronsave.io/ru/skolko-energii-nuzhno-dlya-perevoda-usdt/)). Если не указать `durationSec`, по умолчанию будет 259 200 (3 дня). При успехе вы получите только `orderId` — так и должно быть.
4.  **Опрашивайте исполнение.** `get_order()` возвращает текущее состояние заказа: `fulfilledPercent` (0 — ещё в ожидании, 1–99 — частично, 100 — выполнен), `remainAmount`, фактическую цену `price` в SUN, `payoutAmount` в SUN и массив `delegates` с адресом провайдера, объёмом и ончейн-`txid` для каждого совпадения. Сохраняйте эти txid в логах — это ваша квитанция, которую можно проверить в Tronscan.

## Как выбрать unitPrice

`unitPrice` принимает либо целое число — цену в SUN, — либо один из трёх уровней, причём уровни рассчитываются по текущему стакану, а не являются фиксированной наценкой:

| Значение | Поведение | Когда использовать |
| --- | --- | --- |
| `"SLOW"` | Минимальная цена, по которой можно выставить заказ | Время не критично, экономия важнее скорости |
| `"MEDIUM"` | По умолчанию. Минимальная цена, при которой рынок ещё даёт максимальное исполнение; если рынок не может исполнить заказ совсем, MEDIUM = SLOW + 10 | Почти всегда |
| `"FAST"` | Если рынок готов на 100%, FAST = MEDIUM; если меньше — MEDIUM + 10; при 0% готовности — SLOW + 20 | Перевод нужно отправить прямо сейчас |
| `80` (число) | Фиксированная цена в SUN, полный контроль | Вы сами рассчитываете цену по стакану заявок |

## Обработка ошибок, которые реально встречаются

Ответы с кодом не 2xx приходят с `error: true` и кодом внутри `message`, например `TSAS:106 API_KEY_REQUIRED`. Ветвите логику по коду, а не по тексту — формулировка может измениться. Вот ошибки, с которыми Python-бот сталкивается в продакшене:

-   `INTERNAL_BALANCE_ACCOUNT_TOO_LOW` — пополните внутренний аккаунт. Алерт на это лучше настроить заранее, а не после.
-   `PRICE_EXCEED_MAX_PRICE_REQUIRED` — рыночная цена поднялась выше вашего `maxPriceAccepted`. Перечитайте стакан и повторите запрос с более высоким потолком или подождите.
-   `CANNOT_FULFILLED` — вы указали `onlyCreateWhenFulfilled: true`, а рынок сейчас не может исполнить заказ на 100%. Уберите этот флаг или включите `allowPartialFill`.
-   `MUST_BE_WAIT_PREVIOUS_ORDER_FILLED` — вы отправили те же параметры, пока предыдущий заказ ещё открыт. Это срабатывает `preventDuplicateIncompleteOrders: true` — именно эта опция не даёт циклу повторов купить энергию дважды.
-   `429 RATE_LIMIT` — делайте экспоненциальную паузу (1 с, 2 с, 4 с) и не превышайте 15 запросов в секунду.

Ошибки схемы выглядят иначе: они приходят с HTTP-уровня как `FST_ERR_VALIDATION` и называют отсутствующее поле, например `"body must have required property 'receiver'"`. Это полезно при разработке и говорит о баге в коде, а не о ситуации на рынке.

## Testnet и mainnet

Разрабатывайте в тестовой сети на `https://api-dev.tronsave.io` (Nile, без реальных TRX), а для продакшена переключитесь на `https://api.tronsave.io`. Меняется только домен — все пути остаются прежними, так что достаточно одной константы `TRONSAVE_API_URL`.

Ключ для Nile можно получить на `testnet.tronsave.io`, переключив кошелёк на сеть Nile, а затем пополнить его через кран Nile. Учтите заранее: **API-ключи, балансы и заказы в двух средах полностью разделены**. Ключ от mainnet на тестовом хосте вернёт `INVALID_API_KEY` — это правильное поведение, но в два часа ночи оно сбивает с толку. TronSave не поддерживает Shasta — используйте Nile.

Пишете на другом языке? Тот же сценарий доступен в виде SDK для [Node.js, Rust, Java и PHP](https://blog.tronsave.io/buy-tron-energy-with-code-tronsave-sdk/), а также есть общее [руководство по автоматизации через API](https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-api/). Если не хотите запускать цикл опроса вообще, [Auto-Buy](https://blog.tronsave.io/ru/tronsave-auto-buy-avtopokupka-energii-tron/) пополняет отслеживаемый адрес по заданному вами порогу. Полный справочник — в [документации TronSave](https://docs.tronsave.io).

## Частые вопросы

**Нужен ли TronWeb?**  
Для описанного выше сценария с API-ключом — нет, достаточно обычного `requests`. TronWeb нужен, только если вы подписываете и оплачиваете заказы напрямую приватным ключом — это сценарий с подписанной транзакцией.

**Сколько энергии нужно на один перевод USDT?**  
Около 65 000 (≈130 000 на кошелёк, который ещё никогда не хранил USDT).

**Откуда списывается оплата?**  
С вашего предоплаченного баланса TronSave, который пополняется в [панели](https://tronsave.io/ru/market). Для каждого заказа ничего не подписывается в блокчейне, поэтому скрипту не нужен приватный ключ.

**Что, если заказ исполнится лишь частично?**  
С `allowPartialFill: true` вы получите столько, сколько смог подобрать рынок, `fulfilledPercent` будет между 1 и 99, а оплата спишется только за исполненную часть. Отслеживайте `remainAmount` в цикле и размещайте дополнительный заказ на остаток или укажите `onlyCreateWhenFulfilled: true`, чтобы заказ создавался только тогда, когда его можно исполнить полностью.

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