Руководства по TRON

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

Автор: TronSave Опубликовано 6 мин чтения
Содержание

Если ваш бэкенд на Python отправляет USDT (TRC-20) — бот, биржа, платёжный сервис, — удобнее покупать энергию TRON на Python автоматически, а не вручную. Ниже — полный рабочий пример на TronSave API: скрипт проверяет баланс, размещает заказ на энергию и опрашивает статус, пока энергия не будет доставлена.

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

  • Получите API-ключ в панели TronSave (он списывает средства с вашего внутреннего баланса TronSave — никогда не раскрывайте его на стороне клиента).
  • Установите HTTP-клиент: pip install requests. Нужна типизированная обёртка? Используйте официальный SDK: pip install 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). Если не указать 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, а также есть общее руководство по автоматизации через API. Если не хотите запускать цикл опроса вообще, Auto-Buy пополняет отслеживаемый адрес по заданному вами порогу. Полный справочник — в документации TronSave.

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

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

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

Откуда списывается оплата?
С вашего предоплаченного баланса TronSave, который пополняется в панели. Для каждого заказа ничего не подписывается в блокчейне, поэтому скрипту не нужен приватный ключ.

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

TronSave
TronSave

Команда TronSave создаёт маркетплейс энергии и пропускной способности TRON на tronsave.io и пишет эти руководства по результатам проверок в основной сети TRON.

Похожие статьи

Мы используем Google Analytics, чтобы понимать, какие руководства полезны читателям. Файлы cookie устанавливаются, только если аналитика разрешена. Рекламы в блоге нет. Конфиденциальность