新能量质押 Pro 现已上线——保持 TRX 质押,每天赚取固定的 TRX 收益。
面向开发者的 REST API

TRON 能量 API

通过 TRONAgg API,你的应用可以用代码为任意 TRON 地址购买 TRON 能量。用 GET /estimate 查询报价,用 POST /buy 下单,用 GET /order/{id} 跟踪订单。订单从你预充值的 TRONAgg 余额中支付,能量会委托给接收地址 1 小时,通常几秒内完成。

基础 URLhttps://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
curl -s https://tronagg.ai/api/v1/account \
  -H "X-API-Key: $TRONAGG_API_KEY"

接口

所有路径都相对于 https://tronagg.ai/api/v1。核心流程是报价、购买、跟踪;公开接口无需密钥。

TRON 能量 API 接口
接口鉴权用途
GET/accountAPI 密钥你的 TRX 余额,以及用于充值的充值地址。
GET/estimateAPI 密钥resource_amount 能量的报价:以 SUN 计的单价、总价、receiver_address 可能产生的一次性激活费,以及订单数量上下限 min_amount 和 max_amount。
POST/buyAPI 密钥从你的余额中为 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
curl -s https://tronagg.ai/api/v1/pricing

报价、购买并跟踪订单

每个示例都会为一个接收地址查询 65,000 能量的报价,用新的 Idempotency-Key 下单购买,再查询订单状态。请先在环境变量中设置 TRONAGG_API_KEY,并替换接收地址。

cURL
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"
JavaScript (Node.js)
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);
Python
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 密钥,并明确确认数量、接收地址和费用。

连接器 URLhttps://mcp.tronagg.ai/mcp
各 AI 助手的配置指南

完整文档与 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。