TRX 能量 API 文档(Ver 5.6.1)

面向开发者的 TRX 能量租赁接口文档,支持余额查询、价格查询、毫秒级下单、订单状态追踪。

网关:https://api.tronspay.com 协议:POST + application/json 签名:MD5

1. 接口约定与鉴权

所有 API 请求体格式为 JSON,通用返回结构为:{"code":1,"msg":"操作成功","data":{}}

https://api.tronspay.com
POST
application/json
UTF-8

QueryInfo 签名

签名示例
sign = md5(userId + token + secretKey)

SubmitOrder 签名

签名示例
sign = md5(address + number + token + secretKey)

QueryOrder 签名

签名示例
sign = md5(orderId + token + secretKey)

2. API账户开通

添加官方 Telegram机器人 后,点击 购买能量->API调用 按钮,会给您一个用户 Id及 SecretKey(签名Key),密钥用于API请求时进行签名验证。

  • 入口:Telegram 机器人 → 购买能量 → API 调用
  • 凭据:userId(用户ID)、secretKey(签名Key)
  • 用途:用于所有 API 的身份与签名校验

建议将 secretKey 保存在服务端,不要暴露在前端或公开仓库。

操作如下图示:

3. 查询接口 QueryInfo

/api/Energy/QueryInfo

用于查询账户余额、储值地址和能量价格列表。

请求参数

是,用户 ID
是,随机时间戳
是,md5(userId + token + secretKey)
请求示例
{
  "userId": "165015550404",
  "token": "1735119988123",
  "sign": "4f2a8c3f9b9f7b0a0e5b5c28f1478abc"
}
响应示例
{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "trxBalance": 19.50,
    "rechargeAddress": "TQXx...RechargeAddress",
    "energyPrice": 2.50
  }
}

返回字段说明

余额,用于支付能量购买订单
用户充值地址,接收 TRX(10Trx 起充),充足后自动到账,无需手动操作
能量单价,以 TRX 计价

4. 下单接口 SubmitOrder

/api/Energy/SubmitOrder

提交能量租赁订单,每笔默认 6.5 万能量,支持毫秒级派发。

请求参数

是,用户 ID
是,能量接收地址
是,能量笔数(整数)
是,随机时间戳
是,md5(address + number + token + secretKey)
请求示例
{
  "userId": "165015550404",
  "address": "TPDoE6f------LLMrgSBB",
  "number": 2,
  "token": "1735119988123",
  "sign": "6d41fce778c2f4f0fdb6358f7a367abc"
}
响应示例
{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "orderId": "4980688112342321122",
    "trxBalance": 16.50,
    "price": 2.50
  }
}

返回字段说明

下单后返回的唯一订单号,可用于查询订单状态
下单后更新的用户余额
本次下单消耗的 TRX 价格

5. 订单查询 QueryOrder

/api/Energy/QueryOrder

查询已下单订单状态。该接口可选接入,主要用于运营侧追踪。

请求参数

是,用户 ID
是,订单号
是,随机时间戳
是,md5(orderId + token + secretKey)
响应示例
{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "Id": "4980688112342321122",
    "Address": "TPDoE6f------LLMrgSBB",
    "Duration": 60,
    "Trx": 2.50,
    "State": 4,
    "StateTime": "2025-08-01 16:29:48",
    "Remark": "质押完成",
    "CreateTime": "2025-08-01 16:28:52"
  }
}

返回字段说明

订单号,用于唯一标识一笔订单
能量接收地址
租赁时长,单位为分钟
本次订单消耗的 TRX 价格
订单状态,1:等待处理;2:处理中;3:处理失败;4:质押完成;5:解押完成;6:订单撤销;
状态变更时间
系统处理备注信息
订单创建时间

6. 状态码与错误码

待处理
处理中
处理失败
质押完成
解押完成
订单撤销

常见错误

  • 签名错误:sign 计算顺序或 key 错误
  • 余额不足:trxBalance 不足以支付订单 price
  • 地址非法:接收地址格式不符合 TRON 标准