tronsave (Python)

Fully-typed Python SDK for the Tronsave v2 API (TRON Energy & Bandwidth). Python 3.9+, built on httpx.

Install

pip install tronsave

Quick start

import os
from tronsave import TronsaveClient, Network

sdk = TronsaveClient(api_key=os.environ["TRONSAVE_API_KEY"], network=Network.MAINNET)

me = sdk.get_user_info()
print(me.balance, "SUN")

est = sdk.estimate_buy_resource({
    "receiver": "TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM",
    "resourceType": "ENERGY",
    "resourceAmount": 65000,   # ENERGY must be > 64000
    "durationSec": 3600,
})

order = sdk.buy_resource(
    {"receiver": "TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM", "resourceAmount": 65000, "durationSec": 3600},
    {"allowPartialFill": True, "maxPriceAccepted": 100},
)

status = sdk.get_order(order.order_id)
print(status.fulfilled_percent)  # 100 = fully delegated

Errors

All exceptions subclass tronsave.TronsaveError (.code, .status, .raw): TronsaveAuthError (401), TronsaveValidationError / TronsaveBusinessError (400), TronsaveRateLimitError (429, .retry_after_ms), TronsaveNetworkError (transport).

from tronsave import TronsaveBusinessError, TronsaveRateLimitError

try:
    sdk.buy_resource({"receiver": "T...", "resourceAmount": 65000})
except TronsaveRateLimitError as e:
    print("retry after", e.retry_after_ms, "ms")
except TronsaveBusinessError as e:
    print(e.code, e.status)

Notes

• Defaults: ENERGY, MEDIUM, durationSec=259200.
• ENERGY resourceAmount must be > 64000 (rejected client-side).
• extendTo is a Unix timestamp in seconds.
• Rate limits enforced client-side (15/s; 1/s for get_extendable_delegates).

Develop

pip install -e ".[dev]"
pytest   # runs the shared conformance suite (needs Node.js for the mock server)

See ../../spec/PARITY.md for cross-language parity.