API de energía TRON

Cinco solicitudes te llevan de un precio a un pedido delegado: estimación, cotización, pedido, consulta, webhook. Cada solicitud va firmada con HMAC, cada pedido lleva tu propia clave de idempotencia y el contrato se publica como OpenAPI, no se describe en prosa.

URL base https://api.tenergy.me/v1 en mainnet y https://api-nile.tenergy.me/v1 en Nile, con claves, cuenta y libro contable separados.

  • OpenAPI
  • HMAC
  • Webhooks
  • TS SDK
  • Python SDK
  • Servidor MCP
  • Testnet Nile

Estima un pedido — sin clave

curl -sG https://api-nile.tenergy.me/v1/estimate \
  -d resource=energy -d amount=65000 -d tier=1h
const query = new URLSearchParams({ resource: "energy", amount: "65000", tier: "1h" });
const res = await fetch(`https://api-nile.tenergy.me/v1/estimate?${query}`);
const estimate = await res.json();

// integers in SUN: 1 TRX = 1,000,000 SUN
console.log(estimate.price_sun_per_unit, "SUN per energy");
console.log(estimate.total_amount_sun / 1e6, "TRX for 65,000 energy, 1 hour");
import json, urllib.parse, urllib.request

query = urllib.parse.urlencode({"resource": "energy", "amount": 65000, "tier": "1h"})
with urllib.request.urlopen(f"https://api-nile.tenergy.me/v1/estimate?{query}") as res:
    estimate = json.load(res)

# integers in SUN: 1 TRX = 1,000,000 SUN
print(estimate["price_sun_per_unit"], "SUN per energy")
print(estimate["total_amount_sun"] / 1e6, "TRX for 65,000 energy, 1 hour")
Run envía una consulta de precio a api.tenergy.me (mainnet, pública, sin clave); los ejemplos de código usan la testnet Nile.
Presiona Ejecutar para ver la respuesta en vivo.

Tres formas de comprar

La misma energía, la misma delegación en la cadena — la ruta depende de quién compra y con qué frecuencia.

CómoQué necesitasCuentaPrecio
Transferencia directaUna billetera TRON: envía TRX a la dirección del formulario de pedidoNo hace faltaTus TRX ÷ el precio en vivo, desde 64,000 de energía
PanelInicia sesión con tu billetera, recarga el saldoInicio de sesión con billeteraEl precio en vivo
APIUna clave de API y un saldo recargadoInicio de sesión con billetera, clave de APIEl precio en vivo

SDKs y paquetes

SDK de TypeScript y Python @tenergy/sdk · tenergy

Un método tipado por operación, en ambos lenguajes.

  • Firma cada solicitud con un timestamp nuevo, incluidos los reintentos
  • Reintenta solo GET y DELETE; una creación se envía una vez
  • waitForOrder / wait_for_order y verificación de webhooks incluidos

Publicados en npm y PyPI en versión beta. Sin dependencia, el helper de firma del inicio rápido hace lo mismo en cURL, TypeScript o Python.

Cinco líneas hasta tu primer pedido

import { TenergyClient } from "@tenergy/sdk";

const tenergy = new TenergyClient({
  baseUrl: "https://api-nile.tenergy.me/v1",
  apiKey: process.env.TENERGY_KEY!,
  apiSecret: process.env.TENERGY_SECRET!,
});

const quote = await tenergy.createQuote({
  resource: "energy", amount: 65_000, tier: "1h", receiver,
});
const order = await tenergy.createOrder({
  quote_id: quote.id, client_order_id: `payout-${invoiceId}`,
});
const done = await tenergy.waitForOrder(order.id);
if (done.partial) await reconcile(done.delivered_amount, done.refunded_amount_sun);
import os
from tenergy import Client

tenergy = Client(
    os.environ["TENERGY_KEY"], os.environ["TENERGY_SECRET"], network="nile",
)

quote = tenergy.create_quote({
    "resource": "energy", "amount": 65_000,
    "tier": "1h", "receiver": receiver,
})
order = tenergy.create_order({
    "quote_id": quote["id"], "client_order_id": f"payout-{invoice_id}",
})
done = tenergy.wait_for_order(order["id"])
if done.get("partial"):
    reconcile(done["delivered_amount"], done["refunded_amount_sun"])
PaqueteQué esGuía
@tenergy/sdkTypeScript, tipado, generado desde el contrato · beta en npmGuía del SDK
tenergyPython, clientes síncrono y asíncrono, verificación de webhooks · beta en PyPIGuía del SDK
mcp.tenergy.meServidor MCP alojado para agentes · nada que instalarMCP

¿Ya usas otro servicio de energía? No hace falta ningún paquete: conserva tu API y cambia la URL base. APIs compatibles →

Documentación que puedes leer en cualquier orden

Tres columnas, búsqueda con Ctrl K, código en cURL, TypeScript y Python, la referencia completa de la API — y cada página en markdown en su propia ruta más .md.

Abrir la documentación →
La página de inicio rápido de la documentación de TEnergy: navegación a la izquierda, pestañas de código en el centro, el índice de la página a la derecha

Legible por máquinas

DocumentoPara qué sirve
/openapi.yamlEl contrato completo de la API. Genera un cliente a partir de él.
/llms.txtUn mapa curado para un agente: qué leer, en el orden que lo lleva a una compra.
/llms-full.txtTodo el corpus en un solo archivo markdown, para agentes que prefieren una descarga a veinte.
/.well-known/quickstart.jsonEl flujo de compra en JSON: endpoints, autenticación, unidades, qué pasos requieren a una persona.
/docs/agent-quickstartEl prompt de operador para pegar en tu propio agente, con un botón para copiar.
/docs/quickstart.mdCada página de la documentación en markdown: agrega .md a su ruta.

Preguntas frecuentes

¿Cómo se autentica una solicitud?

Tres headers: X-API-KEY, X-API-TIMESTAMP y X-API-SIGN, donde la firma es base64(HMAC-SHA256(secret, timestamp + method + path + query + body)). La tolerancia del reloj es de cinco segundos.

¿Qué permisos recibe una clave nueva?

Exactamente los que elijas. scopes es obligatorio, no hay un conjunto por defecto ni casillas preseleccionadas en ningún lugar — ni en el contrato, ni en el panel, ni en el flujo de agentes.

¿Consultas periódicas o webhooks?

Webhooks si tienes un endpoint HTTPS público: los firmamos y tú los verificas. Consultar GET /v1/orders/{id} está documentado como alternativa soportada, porque muchos entornos de agentes no tienen URL pública.

¿No encontró su respuesta? Escríbanos por Telegram a @tenergymebot o a support@tenergy.me y la añadiremos aquí.