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 标准