型号 THENERGY API格式 REST · JSONRU · EN · 中文← 首页

API 文档

用 Telegram 机器人余额租赁 TRON 能量
能量委托后有效期 60 分钟。

01 —— 开始

在机器人获取密钥：🔑 API 按钮 → “创建密钥”。trn_… 字符串只显示一次——请立即复制。
用请求头签名：X-API-Key: trn_… 或 Authorization: Bearer trn_…。

从机器人余额扣费。限制：每个密钥每分钟 30 次请求。

02 —— 接口

POST/v1/energy/rent

向指定地址租赁能量。

字段	说明
`address`	TRON 接收地址，以 T 开头，34 个字符
`energy`	仅限 `65000` · `66000` · `131000`。价格：100 / 110 / 200 RUB
`client_key`	可选。订单标记：用相同标记重复请求将返回已创建的订单，不再重复扣费，可放心“重试”

成功 —— 200。响应示例：

{"order_id": "7514cf6659a8ff19fe8105d63a8c994e",
  "address": "T...",
  "energy": 65000,
  "cost": 100,
  "balance": 400.0}

GET/v1/balance

与密钥绑定的机器人余额。“密钥可用吗？”也在这里查询。

{"user_id": 123456,
  "balance": 1240.5}

GET/v1/orders?limit=20

最近订单，1 到 100 条。

{"orders": [
    {"order_id": "7514cf6659a8ff19fe8105d63a8c994e",
     "energy": 65000,
     "cost": 100,
     "date": "2026-10-09T12:00:00",
     "source": "api"}
  ]}

GET/v1/prices

套餐和价格。

{"currency": "RUB",
  "duration": "1h",
  "prices": [
    {"energy": 65000, "cost": 100},
    {"energy": 66000, "cost": 110},
    {"energy": 131000, "cost": 200}
  ]}

03 —— 错误

代码	含义及办法
`401`	未提供密钥或密钥不对。请检查整个请求头——首尾空格也算在内
`402`	余额不足。响应中有 `need` 和 `balance`——请在机器人补足差额
`403`	密钥已撤销、请求 IP 不在白名单或用户被封禁
`422`	未知套餐、地址格式错误或地址在 TRON 未激活
`429`	达到限流。请等待一分钟
`502`	能量发送失败。未扣费——请稍后用相同 `client_key` 重试

04 —— 在线调试

发送真实请求到 …。

密钥请求

05 —— 示例

curl —— 租赁：

curl -X POST https://api.thenergy.xyz/v1/energy/rent   -H "X-API-Key: trn_..." -H "Content-Type: application/json"   -d '{"address":"T...","energy":65000,"client_key":"order-1"}'

Python：

import requests

BASE = "https://api.thenergy.xyz"
HEADERS = {"X-API-Key": "trn_..."}  # 机器人获取的密钥：API 按钮

# 余额
print(requests.get(BASE + "/v1/balance", headers=HEADERS).json())

# 租赁能量
payload = {
    "address": "T...",
    "energy": 65000,
    "client_key": "order-1",  # 可选字段
}
r = requests.post(BASE + "/v1/energy/rent", headers=HEADERS, json=payload)
print(r.status_code, r.json())