TRX能量购买API文档

API接口下单有什么好处？

1. 使用API下单，不用每笔都进行转账。在量大的时候可以大量减少TRX燃烧损耗。
2. 无需经过区块链转账，时间更快，可以毫秒级租赁Trx能量。
3. 更灵活，可以指定地址、时长、Trx能量多少等进行派发Trx能量。

怎么创建API帐户？

首先，您需要一个API帐户才可以进行API下单，开通API账户请联系TG客服(需要科学上网)。
添加官方Telegram机器人后，点击 购买能量->API调用 按钮，会给您一个用户 Id及 SecretKey(签名Key)，密钥用于API请求时进行签名验证。
注：用户 Id 与 APIKey 可通过右上角Telegram能量机器人自动领取。

接口约定

请求内容类型为：application/json，下文中的secretKey指签名Key。
输出格式：{"code":1,"msg":"操作成功","data":返回内容 }，code 为1时正常，不为1时会有对应的错误信息。例如：{"code":0,"msg":"签名错误!"}。
接口网关：https://api.tronspay.com

查询接口

您可以通过该接口查询您的余额信息，及可用的Trx能量价格列表。
API地址：/api/Energy/QueryInfo

参数名	类型	描述
userId	字符串	用户 Id，通过添加Telegram机器人获取。
token	字符串	随机时间戳
sign	字符串	签名方式：md5(userId + token + secretKey)

输出Data：{"trxBalance":19.50,"rechargeAddress":"您的储值地址" "energyPrice":每笔能量价格 }

参数名	类型	描述
trxBalance	小数	用户余额
rechargeAddress	字符串	您的储值地址，将TRX（10Trx起）转至该地址上会自动变成您的余额。
energyPrice	小数	Trx每笔能量价格

下单接口

通过该接口，您可以下单指定Trx能量自由派发。
API地址：/api/Energy/SubmitOrder

参数名	类型	描述
userId	字符串	用户 Id，通过添加Telegram机器人获取。
address	字符串	TRX能量接收地址
number	整数	能量笔数，每笔为6.5万能量
token	字符串	随机时间戳
sign	字符串	签名方式：md5(address + number + token + secretKey)

输出Data：{"orderId":"4980688112342321122","trxBalance":16.50,"price":2.5}

参数名	类型	描述
orderId	字符串	订单号，可用于订单状态查询
trxBalance	小数	TRX余额。
price	小数	该订单的TRX价格。

订单查询

用来查询已经下单的订单状态，此API接口只用于查询，可以不对接。
API地址：/api/Energy/QueryOrder

参数名	类型	描述
userId	字符串	用户 Id，通过添加Telegram机器人获取。
orderId	字符串	订单号
token	字符串	随机时间戳
sign	字符串	签名方式：md5(orderId + token + secretKey})

返回实体如下：

参数名	类型	描述
Id	字符串	订单号，可用于订单状态查询
Address	字符串	能量接收地址。
Duration	整数	TRX能量时长，单位：分。
Trx	小数	TRX能量价格。
State	整数	值说明：1:待处理;2:处理中;3:处理失败;4:质押完成;5:解押完成;6:订单撤销;
StateTime	时间	状态发生变化的时间。
Remark	字符串	提示消息。
CreateTime	时间	订单建立时间。