https://github.com/tron-energy-market/tronzap-sdk-python
Tron Energy Rental - Python SDK for TronZap API
https://github.com/tron-energy-market/tronzap-sdk-python
blockchain buy-energy buy-tron-energy buy-trx-energy tron-api tron-blockchain tron-energy tron-energy-api tron-energy-leasing tronlink trx-energy trx-energy-rental
Last synced: 3 months ago
JSON representation
Tron Energy Rental - Python SDK for TronZap API
- Host: GitHub
- URL: https://github.com/tron-energy-market/tronzap-sdk-python
- Owner: tron-energy-market
- License: mit
- Created: 2025-04-02T11:14:29.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-11T13:14:21.000Z (6 months ago)
- Last Synced: 2026-02-10T22:33:09.684Z (4 months ago)
- Topics: blockchain, buy-energy, buy-tron-energy, buy-trx-energy, tron-api, tron-blockchain, tron-energy, tron-energy-api, tron-energy-leasing, tronlink, trx-energy, trx-energy-rental
- Language: Python
- Homepage: https://tronzap.com/
- Size: 79.1 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.es.md
- License: LICENSE
Awesome Lists containing this project
README
# TronZap SDK para Python
[English](https://github.com/tron-energy-market/tronzap-sdk-python/blob/main/README.md) | **[Español](https://github.com/tron-energy-market/tronzap-sdk-python/blob/main/README.es.md)** | [Português](https://github.com/tron-energy-market/tronzap-sdk-python/blob/main/README.pt-br.md) | [Русский](https://github.com/tron-energy-market/tronzap-sdk-python/blob/main/README.ru.md)
SDK oficial en Python para la API de TronZap.
Este SDK permite integrar fácilmente los servicios de TronZap para alquilar energía TRON.
TronZap.com permite [comprar energía TRON](https://tronzap.com/), reduciendo significativamente las comisiones en transferencias de USDT (TRC20).
👉 [Regístrate para obtener una clave API](https://tronzap.com) para comenzar a usar la API de TronZap e integrarla a través del SDK.
## Instalación
```bash
pip install tronzap-sdk
```
## Inicio Rápido
```python
from tronzap_sdk import Client
# Inicializar el cliente
client = Client(
api_token="tu_api_token",
api_secret="tu_api_secret"
)
# Obtener servicios disponibles
services = client.get_services()
print(services)
# Obtener saldo de la cuenta
balance = client.get_balance()
print(balance)
# Estimar costo de energía para transferencia USDT
estimate = client.estimate_energy('DIRECCION_ORIGEN_TRX', 'DIRECCION_DESTINO_TRX', 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t')
print(estimate)
# Calcular costo de energía
calculation = client.calculate(
address="DIRECCION_BILLETERA_TRON",
energy=65150 # Cantidad recomendada para transferencias USDT
)
print(calculation)
# Crear transacción de energía
transaction = client.create_energy_transaction(
address="DIRECCION_BILLETERA_TRON",
energy_amount=65150, # Desde 60000
duration=1, # Valores posibles 1 o 24 horas
activate_address=True # Si la dirección necesita activación
)
print(transaction)
# Comprar ancho de banda
bandwidth = client.create_bandwidth_transaction(
address="DIRECCION_BILLETERA_TRON",
amount=1000,
external_id="bandwidth-1"
)
print(bandwidth)
# Verificar estado de la transacción
status = client.check_transaction(id="ID_TRANSACCION")
print(status)
# Crear chequeo AML
aml_check = client.create_aml_check(
type="address",
network="TRX",
address="TXYZ1234567890EXAMPLEADDRESS"
)
print(aml_check)
# Verificar estado AML
aml_status = client.check_aml_status(id=aml_check["id"])
print(aml_status)
# Obtener información de recarga directa
recharge_info = client.get_direct_recharge_info()
print(recharge_info)
```
## Características
- Obtener servicios disponibles
- Obtener servicios AML
- Obtener saldo de la cuenta
- Calcular costo de energía
- Crear transacciones de activación de dirección
- Crear transacciones de compra de energía
- Crear transacciones de compra de ancho de banda
- Crear y seguir chequeos AML
- Verificar estado de transacciones
- Obtener información de recarga directa
## Requisitos
- Python 3.7 o superior
- requests >= 2.25.0
## Manejo de Errores
El SDK utiliza una jerarquía de excepciones para un manejo preciso de errores:
```
TronZapException
├── ApiException — errores a nivel de API (code != 0 en la respuesta)
├── NetworkException — errores de red/conectividad
│ ├── ConnectionException — no se pudo conectar al servidor
│ ├── TimeoutException — tiempo de espera agotado
│ └── SslException — errores SSL/TLS
└── HttpException — respuestas HTTP no 2xx
├── RateLimitException — HTTP 429 Too Many Requests
├── UnauthorizedException — HTTP 401/403
└── ServerException — errores HTTP 5xx
```
### Ejemplo
```python
from tronzap_sdk import Client
from tronzap_sdk.exceptions import (
ApiException,
ConnectionException,
HttpException,
NetworkException,
RateLimitException,
ServerException,
SslException,
TimeoutException,
TronZapException,
UnauthorizedException,
ErrorCode,
)
client = Client(api_token="tu_api_token", api_secret="tu_api_secret")
try:
transaction = client.create_energy_transaction("TRX_ADDRESS", 65000, 1)
except ApiException as e:
# Error a nivel de API (parámetros inválidos, fondos insuficientes, etc.)
print(f"Error API [{e.code}]: {e.message}")
# Clave alias del error, p.ej. "invalid_tron_address" o "invalid_tron_address.from_address"
if e.error_key:
print(f"Clave de error: {e.error_key}")
if e.code == ErrorCode.INVALID_TRON_ADDRESS:
print("Revisa el formato de la dirección TRON.")
except RateLimitException:
print("Demasiadas solicitudes. Reduce la frecuencia.")
except UnauthorizedException:
print("Token API o firma inválidos.")
except ServerException as e:
print(f"Error del servidor TronZap [{e.status_code}].")
except HttpException as e:
print(f"Error HTTP [{e.status_code}]: {e.message}")
except TimeoutException:
print("Tiempo de espera agotado.")
except SslException as e:
print(f"Error SSL: {e.message}")
except ConnectionException as e:
print(f"Error de conexión: {e.message}")
except NetworkException as e:
print(f"Error de red: {e.message}")
except TronZapException as e:
print(f"Error [{e.code}]: {e.message}")
```
### Códigos de Error
| Código | Constante | Descripción |
|--------|----------------------------------|-------------|
| 1 | `AUTH_ERROR` | Error de autenticación – Token API o firma inválida |
| 2 | `INVALID_SERVICE_OR_PARAMS` | Servicio o parámetros inválidos |
| 5 | `WALLET_NOT_FOUND` | Cartera interna no encontrada. Contacte con soporte. |
| 6 | `INSUFFICIENT_FUNDS` | Fondos insuficientes |
| 10 | `INVALID_TRON_ADDRESS` | Dirección TRON inválida |
| 11 | `INVALID_ENERGY_AMOUNT` | Cantidad de energía inválida |
| 12 | `INVALID_DURATION` | Duración inválida |
| 20 | `TRANSACTION_NOT_FOUND` | Transacción no encontrada |
| 24 | `ADDRESS_NOT_ACTIVATED` | Dirección no activada |
| 25 | `ADDRESS_ALREADY_ACTIVATED` | La dirección ya está activada |
| 30 | `AML_CHECK_NOT_FOUND` | Chequeo AML no encontrado |
| 35 | `SERVICE_NOT_AVAILABLE` | Servicio no disponible |
| 500 | `INTERNAL_SERVER_ERROR` | Error interno del servidor – Contacta con soporte |
## Soporte
Para soporte, contáctanos en Telegram: [@tronzap_bot](https://t.me/tronzap_bot)
## Licencia
Este proyecto está licenciado bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para más detalles.