TRON 能量开放 API
仅需五个请求即可完成从算价到能量委托的全流程：预估、报价、下单、轮询、Webhook 回调。所有请求均采用 HMAC 签名，每个订单支持自定义幂等键，协议完全基于 OpenAPI 规范发布。
主网接口根地址为 https://api.tenergy.me/v1，Nile 测试网为 https://api-nile.tenergy.me/v1，拥有独立的 API 密钥、测试账户与账本。
- OpenAPI 规范
- HMAC 签名
- Webhooks
- TypeScript SDK
- Nile 测试网
订单费用预估 — 无需 API 密钥
curl -sG https://api-nile.tenergy.me/v1/estimate \
-d resource=energy -d amount=65000 -d tier=1hconst 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")点击「发送请求」查看实时接口返回。
四种灵活购买途径
完全相同的链上能量委托交付 — 根据您的调用规模和自动化程度自由选择。
| 途径 | 准入要求 | 首次接入耗时 | 计费标准 |
|---|---|---|---|
| 直接转账 | 零门槛 — 向指定地址转账 TRX 并在 Memo 备注接收地址 | 数秒即达 | 每 65,000 能量固定 3.00 TRX |
| 控制台快捷购买 | 钱包连接签名，充值入账 | 两分钟内 | 官方公布阶梯价格 |
| REST API 接入 | 生成 API 密钥并充值余额 | 单次请求 | 官方公布阶梯价格 |
| MCP 服务 / AI Agent | 使用相同的 API 密钥 | 一次工具调用 | 官方公布阶梯价格 |
SDK 与平滑迁移兼容层
TypeScript SDK @tenergy/sdk
基于 OpenAPI 规范自动生成的全类型化客户端代码库。
- 自动为每次请求附带最新时间戳与数字签名，内置智能重试机制
- 仅针对安全且幂等的 GET 和 DELETE 进行自动重试；创建订单严格保证单次提交
- 内置 waitForOrder 订单状态等待与 Webhook 签名快速验签函数
npm 包即将发布 — 在此之前，快速入门指南中提供了 cURL、TypeScript 及 Python 版本的签名生成助手函数。
五行代码完成首笔订单
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);| 兼容包 | 适配结构 | 迁移文档 |
|---|---|---|
| @tenergy/sdk | 原生客户端，完整类型支持，直接基于 OpenAPI 契约生成 | 阅读 SDK 指南 |
| @tenergy/catfee-compat | 兼容 CatFee 的客户端调用方法与 Webhooks 格式 | /compare/catfee |
| @tenergy/netts-compat | 兼容 Netts 的订单接口与调度器 | /compare/netts |
| @tenergy/feesaver-compat | 兼容 FeeSaver 的 buyEnergy 与状态查询格式 | /compare/feesaver |
| @tenergy/tronzap-compat | 针对 tronzap-sdk 的即插即用平替 | /compare/tronzap |
自动化迁移垫片包即将发布；当前可通过各平台的迁移指南逐个接口无缝映射接入。
支持任意顺序阅读的现代化文档
三栏式布局，支持 Ctrl+K 全局极速搜索，提供 cURL、TypeScript、Python 多语言代码片段，接口参考直接源自契约生成 — 每个文档页面在路径后附加 .md 即可直接获取 Markdown 格式原文。
浏览开发文档 →
机器可读规范
| 规范文档 | 用途说明 |
|---|---|
| /openapi.yaml | 契约源头。直接用于代码生成；任何与说明文字冲突之处以本契约规范为准。 |
| /llms.txt | 专为 AI Agent 优化的上下文导图：按最短采购路径编排的必读文档精选。 |
| /llms-full.txt | 将完整语料库聚合为单个 Markdown 文件，适合偏好一次性读取的 Agent。 |
| /.well-known/quickstart.json | JSON 格式购买流程：包含端点、鉴权、计量单位及需要人工确认的步骤。 |
| /docs/agent-quickstart | 直接粘贴至您自己编码 Agent 中的操作者系统提示词，支持一键复制。 |
| /docs/quickstart.md | 所有文档页面均提供 Markdown 格式：在任意文档 URL 后附加 .md 即可获取。 |
常见问题
API 请求如何进行身份签名验证？
需要提供三个请求头：X-API-KEY、X-API-TIMESTAMP 及 X-API-SIGN。签名算法为 base64(HMAC-SHA256(secret, timestamp + method + path + query + body))。允许的时钟偏差为 5 秒以内。
新建的 API 密钥默认具有哪些权限？
严格取决于您勾选的权限范围。scopes 字段为必填项，无论在合约层、控制台还是 Agent 接入流程中，均不提供默认权限，也不存在任何隐式预选。
应该使用轮询还是 Webhooks？
如果您拥有公网 HTTPS 服务器，强烈推荐使用 Webhook 回调：我们对每次回调附带签名，您只需验签即可。对于没有公网 URL 的 Agent 本地运行时，文档支持轮询 GET /v1/orders/{id} 作为官方备选方案。