TRON 能量 API
通过 TRONAgg API,你的应用可以用代码为任意 TRON 地址购买 TRON 能量。用 GET /estimate 查询报价,用 POST /buy 下单,用 GET /order/{id} 跟踪订单。订单从你预充值的 TRONAgg 余额中支付,能量会委托给接收地址 1 小时,通常几秒内完成。
https://tronagg.ai/api/v1鉴权
每个账户接口都需要在 X-API-Key 请求头中携带 API 密钥。在 TRONAgg 工作台的「API 密钥」中创建密钥;密钥以 ta_ 开头。请把密钥保存在你的服务器上,因为它可以动用你的余额。
价格接口和能量估算接口是公开的,无需密钥。你还可以把密钥限定在一组 IP 地址或 CIDR 网段内;来自其他地址的请求会收到 403 ip_not_allowed。
整数金额以 SUN 为单位(1 TRX = 1,000,000 SUN)。以 _trx 结尾的字段以及 unit_price_sun 是十进制字符串:请用十进制类型解析,不要用浮点数。
curl -s https://tronagg.ai/api/v1/account \
-H "X-API-Key: $TRONAGG_API_KEY"接口
所有路径都相对于 https://tronagg.ai/api/v1。核心流程是报价、购买、跟踪;公开接口无需密钥。
| 接口 | 鉴权 | 用途 |
|---|---|---|
| GET/account | API 密钥 | 你的 TRX 余额,以及用于充值的充值地址。 |
| GET/estimate | API 密钥 | resource_amount 能量的报价:以 SUN 计的单价、总价、receiver_address 可能产生的一次性激活费,以及订单数量上下限 min_amount 和 max_amount。 |
| POST/buy | API 密钥 | 从你的余额中为 receiver_address 购买能量,返回 201 和一个状态为 PENDING 的 order_id。请发送 Idempotency-Key 请求头,这样重试永远不会重复扣费。 |
| GET/order/{id} | API 密钥 | 订单状态、扣费总额以及链上委托交易 ID;订单变为 COMPLETED 后,这些 ID 通常列在 delegation_txids 中。 |
| GET/pricing | 公开 | 以 SUN 计的实时每单位能量价格及市场均价,以及 65,000 和 131,000 能量订单的 TRX 费用。 |
| GET/pricing/history | 公开 | 我们的价格与市场均价的历史对比:按小时最多 168 小时,或按天最多 365 天。 |
| GET/pricing/auto-energy | 公开 | AutoEnergy 套餐价格:开通费、每日费用和按笔收费。 |
| GET/calculator/estimate-energy | 公开 | 模拟两个地址之间的一笔 TRC20 转账(默认 USDT),返回它将消耗的精确能量。 |
订单历史、余额流水、充值、Webhook 和 AutoEnergy 订阅,详见完整 API 文档。
代码示例
无需密钥直接试用
直接在终端里获取 JSON 格式的实时价格:
curl -s https://tronagg.ai/api/v1/pricing报价、购买并跟踪订单
每个示例都会为一个接收地址查询 65,000 能量的报价,用新的 Idempotency-Key 下单购买,再查询订单状态。请先在环境变量中设置 TRONAGG_API_KEY,并替换接收地址。
curl -s -G https://tronagg.ai/api/v1/estimate \
-d resource_amount=65000 \
-d receiver_address=TYourReceiverAddress \
-H "X-API-Key: $TRONAGG_API_KEY"
ORDER_ID=$(curl -s -X POST https://tronagg.ai/api/v1/buy \
-H "X-API-Key: $TRONAGG_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"receiver_address": "TYourReceiverAddress", "resource_amount": 65000}' \
| jq -r .order_id)
curl -s "https://tronagg.ai/api/v1/order/$ORDER_ID" \
-H "X-API-Key: $TRONAGG_API_KEY"import { randomUUID } from "node:crypto";
import { setTimeout as sleep } from "node:timers/promises";
const BASE_URL = "https://tronagg.ai/api/v1";
const headers = { "X-API-Key": process.env.TRONAGG_API_KEY };
const receiver = "TYourReceiverAddress";
const quote = await fetch(
`${BASE_URL}/estimate?resource_amount=65000&receiver_address=${receiver}`,
{ headers },
).then((res) => res.json());
console.log("Total:", quote.total_price_trx, "TRX");
const res = await fetch(`${BASE_URL}/buy`, {
method: "POST",
headers: {
...headers,
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({ receiver_address: receiver, resource_amount: 65000 }),
});
const purchase = await res.json();
if (res.status !== 201) throw new Error(JSON.stringify(purchase.detail));
let order;
do {
await sleep(3000);
order = await fetch(`${BASE_URL}/order/${purchase.order_id}`, { headers })
.then((r) => r.json());
} while (!["COMPLETED", "FAILED"].includes(order.status));
console.log(order.status, order.delegation_txids);import os, time, uuid
import requests
BASE_URL = "https://tronagg.ai/api/v1"
HEADERS = {"X-API-Key": os.environ["TRONAGG_API_KEY"]}
receiver = "TYourReceiverAddress"
quote = requests.get(
f"{BASE_URL}/estimate",
headers=HEADERS,
params={"resource_amount": 65000, "receiver_address": receiver},
).json()
print("Total:", quote["total_price_trx"], "TRX")
res = requests.post(
f"{BASE_URL}/buy",
headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
json={"receiver_address": receiver, "resource_amount": 65000},
)
if res.status_code != 201:
raise RuntimeError(res.json()["detail"])
order_id = res.json()["order_id"]
while True:
time.sleep(3)
order = requests.get(f"{BASE_URL}/order/{order_id}", headers=HEADERS).json()
if order["status"] in ("COMPLETED", "FAILED"):
break
print(order["status"], order["delegation_txids"])订单状态
状态值始终为大写。通过 API 下的订单会从 PENDING 变为 COMPLETED 或 FAILED。
- PENDING
- 已从你的余额支付并被受理;能量委托正在进行中。
- COMPLETED
- 能量已委托给接收地址。
delegation_txids通常会列出链上交易 ID。 - FAILED
- 订单未能完成,扣款已自动退回你的余额。
error_message会说明原因。
每 2 到 3 秒轮询一次 GET /order/{id},或注册 Webhook 接收 order.status_changed 事件。直接用钱包支付的订单还可能显示 AWAITING_PAYMENT 或 PROCESSING。
当前限制
- 仅限能量。每个订单都是 TRON 能量:
resource_type始终为ENERGY。 - 委托 1 小时。能量会委托给接收地址一小时:
duration始终为1h。 - 订单数量。
GET /estimate会返回min_amount和max_amount。超出这个范围,POST /buy返回400,不会扣费。 - 预充值余额。订单从你的 TRONAgg 余额中支付;向
GET /account返回的deposit_address发送 TRX 即可充值。余额不足时返回400 insufficient_balance,不会扣费。 - 新地址。如果接收地址尚未在 TRON 上激活,会额外收取一次性激活费,已计入总价。向
GET /estimate传入receiver_address,购买前即可看到这笔费用。 - 速率限制。每个账户每分钟 1,000 次请求,由该账户的所有密钥共享;超出后 API 返回
429和Retry-After响应头。能量估算接口按 IP 限制为每分钟 10 次请求。
面向 AI 助手的 MCP 连接器
同样的操作也以远程 MCP 服务器的形式提供。把连接器 URL 添加到 Claude、ChatGPT、Cursor 或任意 MCP 客户端:价格、报价和能量估算工具无需密钥即可使用;购买则需要在 X-API-Key 请求头中提供你的 API 密钥,并明确确认数量、接收地址和费用。
https://mcp.tronagg.ai/mcp完整文档与 OpenAPI 规范
API 文档涵盖每个接口、错误码和 Webhook。OpenAPI 3.1 规范发布在 https://tronagg.ai/openapi.json:可以导入 Postman 或 Insomnia,也可以用它生成类型化的客户端。
TRON 能量 API 常见问题
- 有可以租用 TRON 能量的 API 吗?
- 有。TRONAgg REST API(https://tronagg.ai/api/v1)可以为任意 TRON 地址租用 TRON 能量:GET /estimate 查询报价,POST /buy 从你的预充值余额下单,GET /order/{id} 告诉你能量何时委托完成。委托持续 1 小时,通常几秒内完成。
- 通过 API 购买 TRON 能量要多少钱?
- 目前 65,000 能量(足够一笔标准 USDT 转账)租用 1 小时需 1.820 TRX(每单位 28 SUN,查询于 2026-10-23)。购买前,GET /estimate 会返回你的订单此刻的费用;传入接收地址,即可把新地址的一次性激活费计算在内。
- TRONAgg API 如何鉴权?
- 在 TRONAgg 工作台的「API 密钥」中创建 API 密钥,并在每个账户请求的 X-API-Key 请求头中携带它。密钥以 ta_ 开头。价格接口和能量估算接口是公开的,无需密钥。
- 购买请求超时怎么办?
- 用同一个 Idempotency-Key 重试 POST /buy。24 小时内,API 会返回原订单,而不会再下一单;如果第一个请求仍在处理中,则返回 409 duplicate_request。
- 能量多快到账?订单失败怎么办?
- 订单最初的状态是 PENDING,能量通常几秒内完成委托。COMPLETED 订单会列出委托交易 ID;FAILED 订单会自动退款到你的余额。
- AI 智能体能通过 TRONAgg 购买 TRON 能量吗?
- 能。把任意 MCP 客户端连接到 https://mcp.tronagg.ai/mcp。价格和报价工具无需密钥;购买需要在 X-API-Key 请求头中提供你的 API 密钥,并明确确认数量、接收地址和费用。
- API 出售带宽或更长的租期吗?
- 不。API 只出售 TRON 能量,委托 1 小时:resource_type 始终为 ENERGY,duration 始终为 1h。