TRX 能量 API 文档

1. 接入准备

接口基址：https://api.aqtrx.xyz

在 Telegram 机器人中发送 /apikey 获取您的 API Key（/removekey 可重置）。
如需限制来源 IP，发送 /addip 1.2.3.4 添加白名单（为空时允许所有 IP，/clearip 清空）。
所有接口使用 GET 请求，参数放在 URL Query 中。

2. 签名规则

取所有请求参数（含 key），排除 sign 与空值。
按参数名 ASCII 从小到大 排序，拼接为 a=v1&b=v2&key=apikey。
对该字符串做 小写 MD5，结果作为参数 sign 传入。

示例

请求参数：address=TJ...、count=1、timestamp=1767240000、key=abc123

待签名串：address=TJ...&count=1&key=abc123&timestamp=1767240000
sign = md5("address=TJ...&count=1&key=abc123×tamp=1767240000")  // 32位小写

注意：sign 不参与签名；参数值为空的不参与签名；排序按参数名字母升序；timestamp 为必填，与服务器时间偏差不超过 5 分钟。

3. 查询当前价格

GET /api/open/price

参数	必填	说明
key	是	API 密钥
timestamp	是	Unix 时间戳（秒或毫秒），与服务器时间偏差不超过 5 分钟
sign	是	签名

返回示例

{
  "code": 200,
  "message": "成功",
  "data": {
    "price": 1.20,
    "time": "2026-01-01 12:00:00",
    "timestamp": 1767240000
  }
}

4. 查询账户余额

GET /api/open/balance

参数	必填	说明
key	是	API 密钥
timestamp	是	Unix 时间戳（秒或毫秒），与服务器时间偏差不超过 5 分钟
sign	是	签名

返回示例

{
  "code": 200,
  "message": "成功",
  "data": {
    "balance": 100.00,
    "time": "2026-01-01 12:00:00"
  }
}

5. 提交下单

GET /api/open/order

参数	必填	说明
address	是	接收能量的波场钱包地址（T 开头）
count	是	笔数，1-6
traceId	否	调用方业务单号，用于幂等与查询
timestamp	是	Unix 时间戳（秒或毫秒），与服务器时间偏差不超过 5 分钟
key	是	API 密钥
sign	是	签名

返回示例

{
  "code": 200,
  "message": "已受理，正在下单",
  "data": {
    "orderNo": "E20260101120000123456",
    "traceId": "your-trace-001",
    "status": 5,
    "statusText": "已受理",
    "address": "TJ...",
    "count": 1,
    "unitPrice": 1.20,
    "amount": 1.20,
    "energyQty": 65000,
    "hour": 1,
    "createTime": "2026-01-01 12:00:00",
    "errorMsg": null
  }
}

下单费用从账户余额扣除，余额不足将返回失败。下单结果会通过 Telegram 通知到您的账号。

6. 查询订单状态

GET /api/open/order/query

参数	必填	说明
traceId	是	下单时的业务单号
timestamp	是	Unix 时间戳（秒或毫秒），与服务器时间偏差不超过 5 分钟
key	是	API 密钥
sign	是	签名

返回结构与下单一致。

7. 状态码

code	含义
200	成功
400	参数错误 / 业务失败（余额不足、地址非法等）
401	缺少 key / key 无效 / 签名错误
403	IP 不在白名单
500	服务异常

8. 订单状态说明

status	说明
5	已受理，等待下单
1	下单中
2	下单成功
3	下单失败