TronRental API新手指南:7步购买TRON能量
面向无TRON经验开发者的分步指南。从注册到通过API首次购买能量。
本指南适合谁?
本指南面向希望自动化购买TRON能量和带宽的开发者、机器人创建者和企业主。无需TRON经验。
学完本指南后,您将能够查询价格、购买能量和带宽、检查订单状态——全部通过代码完成。
您可以用API做什么:
在每次USDT转账前自动购买能量的机器人
集成到您自己的交易所、钱包或支付服务中
批量为多个地址购买能量
什么是API?为什么要用它?
API(应用程序编程接口)是一种通过代码控制服务的方式,无需在网站上点击按钮。可以把它想象成TronRental的遥控器。
通过TronRental API,您可以完成网站上的所有操作——查询价格、购买能量、购买带宽——但是自动化的,从脚本或服务器执行。
手动 vs API
手动:打开网站、登录、输入地址、选择数量、点击购买、等待、重复
API:一个HTTP请求 → 能量在几秒内被委托。无需浏览器。
第1步 — 注册并登录
访问 tronrental.com 并创建账户。支持通过邮箱、Google、Telegram或TronLink钱包注册。
注册后,进入Dashboard。在这里管理一切:余额、订单、API密钥和设置。
第2步 — 创建API密钥
在Dashboard中,进入API部分并点击"Create API Key"。
重要:API密钥仅显示一次。请复制并妥善保存。如果丢失,需要创建新的。
API密钥就像脚本的密码。它告诉TronRental谁在发送请求,并从您的账户余额中扣费。
可选:可以将密钥限制为特定IP地址以增加安全性。只有来自这些IP的请求会被接受。
可选:设置Webhook URL以在订单状态变更时接收自动通知。
第3步 — 充值
进入 Dashboard → Deposit,复制您的个人充值地址。
向该地址发送TRX或USDT (TRC-20)。充值通常在30秒内确认。
通过API查询余额:
curl -X GET https://tronrental.com/api/v1/account/balance \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get("https://tronrental.com/api/v1/account/balance", headers=headers)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/account/balance", {
headers: { "Authorization": `Bearer ${API_KEY}` }
});
console.log(await res.json());响应:
{
"balance_trx": "150.50",
"balance_usdt": "0.00",
"deposit_address": "TYour1Deposit2Address3Here..."
}第4步 — 查询当前价格
购买前先查询当前价格。此接口是公开的——无需API密钥。
curl -X GET https://tronrental.com/api/v1/prices# Python
import requests
r = requests.get("https://tronrental.com/api/v1/prices")
print(r.json())// JavaScript
const res = await fetch("https://tronrental.com/api/v1/prices");
console.log(await res.json());响应:
{
"energy": {
"1h": "0.84",
"1d": "4.20"
},
"bandwidth": {
"1d": "9.60"
},
"burn_cost_trx": "6.43",
"savings_percent": "87"
}响应字段说明:
- energy.1h — 每1,000单位能量1小时的价格(TRX)
- bandwidth — 每1,000单位带宽1天的价格(TRX)
- burn_cost_trx — 没有能量时会燃烧多少TRX
- savings_percent — 租赁相比燃烧节省多少
价格公式:price_per_1k × (数量 / 1000)。例如,energy.1h = 0.84 TRX,需要65,000能量:0.84 × 65 = 54.6 TRX。
第5步 — 购买能量
现在是核心部分——购买能量。发送POST请求,包含目标地址、数量和时长。
参数:
target_address— 将接收能量的TRON地址volume— 能量数量(最小32,000,最大5,000,000)duration— 租赁期:"1h"(1小时)或"1d"(1天)
需要多少能量?USDT转账:如果接收方已持有USDT需65,000,否则需131,000。
请求:
curl -X POST https://tronrental.com/api/v1/energy/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/energy/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/energy/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 65000,
duration: "1h"
})
});
console.log(await res.json());响应:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "pending",
"created_at": "2026-02-28T12:00:00Z"
}订单状态:
- pending — 订单已创建,等待处理
- delegated — 能量已委托到目标地址
- completed — 租赁期结束,能量已回收
第6步 — 购买带宽
带宽与能量的工作方式相同。任何TRON交易都需要带宽(不仅仅是USDT)。
参数:
target_address— 将接收带宽的TRON地址volume— 带宽数量(最小350,最大100,000)duration— 租赁期:"1h"
每笔带宽订单额外收取0.2 TRX固定费用。
请求:
curl -X POST https://tronrental.com/api/v1/bandwidth/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/bandwidth/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/bandwidth/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 5000,
duration: "1h"
})
});
console.log(await res.json());响应:
{
"id": 1235,
"type": "bandwidth",
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h",
"price_trx": "2.20",
"status": "pending",
"created_at": "2026-02-28T12:05:00Z"
}第7步 — 检查订单状态
下单后,您可以随时检查订单状态。
获取所有订单:
curl -X GET https://tronrental.com/api/v1/orders \
-H "Authorization: Bearer YOUR_API_KEY"按ID获取特定订单:
curl -X GET https://tronrental.com/api/v1/orders/1234 \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
# All orders
orders = requests.get("https://tronrental.com/api/v1/orders",
headers=headers).json()
# Single order
order = requests.get("https://tronrental.com/api/v1/orders/1234",
headers=headers).json()
print(order["status"]) # "delegated"响应:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "delegated",
"delegate_txid": "abc123def456...",
"created_at": "2026-02-28T12:00:00Z",
"delegated_at": "2026-02-28T12:00:04Z"
}查看"status"字段。当显示"delegated"时,能量或带宽已成功交付到目标地址。"delegate_txid"字段包含链上交易哈希。
最佳实践与建议
安全性
永远不要将API密钥硬编码在源代码中。使用环境变量:
Python:
import os
API_KEY = os.environ["TRONRENTAL_API_KEY"]JavaScript/Node.js:
const API_KEY = process.env.TRONRENTAL_API_KEY;IP白名单
生产环境中,务必在API密钥上设置IP白名单。即使密钥泄露,也无法从其他服务器使用。
速率限制
API每个密钥允许60秒内30个请求。超出后将收到429响应。在循环请求间添加小延迟。
常见错误
最常见的错误代码及处理方法:
401 Unauthorized — API密钥无效或缺失。检查Authorization头。
400 Bad Request — 参数无效。检查响应中的错误消息。
402 Payment Required — 余额不足。充值更多TRX。
429 Too Many Requests — 超出速率限制。等待后重试。
Webhooks
不必反复轮询订单状态,设置webhook URL。TronRental会在状态变更时发送POST请求。
Webhook载荷包含完整的订单对象及更新后的状态。
常见问题
USDT转账需要多少能量?
如果接收方已持有USDT需65,000能量,否则需131,000。使用我们的能量计算器检查任何地址。
能量委托多快?
通常在下单后3-5秒内完成。
余额用完会怎样?
API将返回402错误。现有订单保持有效直到租赁期满。只需充值更多TRX即可继续。
我能为别人的地址购买能量吗?
可以。target_address可以是任何有效的TRON地址。您不需要拥有它。
支持哪些编程语言?
任何能发送HTTP请求的语言。我们展示Python、JavaScript和curl示例,但您也可以使用Go、PHP、Java、Rust或其他任何语言。