接入文档

▼

API

▼

准备工作

欢迎阅读 Energy 技术接入文档，在开始接入之前，你需要：

  1. 访问机器人我的钱包。
  2. 在我的钱包自动创建 API 密钥 key。
  3. 设置IP白名单（必须），User-Agent白名单非必须，不限制可留空。
  4. 阅读我们的接口约定及常见问题相关内容。

然后你可以参考后续文档，如有需要协助请联系平台客服或技术

接口约定

请求域名

https://trcgas.com/energy

请求编码

数据编码统一为 utf-8

APIKEY

接口文档中提到的 key，都是指应用的 key，可在用户中心创建或查看。所有请求的 Header 中传入 key，请勿泄漏以免造成资产损失。

数据提交规范

接口按照功能划分请求方式：

  • GET 方法用于所有查询类接口
  • POST 方法用于所有新增、修改、删除等操作类接口

POST 请求默认使用以下请求头：

Content-Type: application/json

如需以表单方式提交参数，请使用：

Content-Type: application/x-www-form-urlencoded

交易查询

如接口有返回 tx_id、frozen_tx_id 等字段，均可前往波场官方区块链浏览器（https://tronscan.org）查询交易详细信息。

状态码

状态码 说明 建议
-1 失败
0 成功
100 请求参数错误 通常出现在 POST 请求上，请检查 json 结构是否正确
11000 操作失败，请稍后再试 通常是业务处理失败，或不能操作，可联系客服处理
11001 操作过于频繁，请稍后再试 针对 key 限制每秒补充最多 5 次，请使用缓存补充至完整的 key
11003 配额已经全部用完 请在用户中心充值
12002 数据不存在
20000 应用不存在
20001 应用已被禁用
20002 余额不足 请到用户中心充值

常见问题

接口有频率限制吗？

针对 key 限制每秒补充最多10次。

有没有接入示例 Demo？

每个接口文档下都有相应的代码示例，如果没有请联系我们更新。

技术对接时遇到问题怎么办？

首先请优先阅读我们的接入文档，如果问题还是无法解决😢，可通过客服渠道和我们取得联系。

下单后如何判断能量是否发送

下单后能量无法立即完成，大约1-3秒能量即可发送到接收钱包。status 等于 2 表示已下单成功，等于 2 表示能量已经发送。等于 14 能量不足已退款。其他的状态可以参考状态码说明。

接口进行判断，需询问友友@westcv提供Golang代码处理思路，可参照参考。

Golang

// 创建一个通道，用于等待结果，设置一个小等待
resultCh := make(chan *utils.OrderQueryResponse, 1)
var wg sync.WaitGroup
wg.Add(1)
// 创建一个上下文和取消函数
ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second)
defer cancel()
// 启动协程
go func() {
    defer wg.Done() // 必须等待的协程数量
    for {
        select {
            case <-ctx.Done():
                // 超时或被取消
                return
            default:
                // 继续执行
        }
    }
}

联系我们

技术客服Telegram

@westcv

技术合作

请通过客服与我们取得联系 @westcv

小时闪租订单,（时长，闪租，指令，彩金，归集）

POST
/api/v1/hourlyFlashRentalOrder

请求参数（Content-Type: application/x-www-form-urlencoded）

参数名称 类型 必需的 描述
address string 是 能量地址
energyNum integer 是 单次发送的能量 如32000/64000
resource String 是 资源类型 能量：ENERGY 宽带：BANDWIDTH 默认是 ENERGY
minutes integer 否 代理时间 基础单位：分钟 默认：60 分钟 (可不填)
secretKey string 是 用户API key

返回参数

参数名称 类型 描述
code integer 返回码，0表示成功，-1表示失败
msg string 返回信息
data object 返回数据

返回示例


{
    "code": 0,
    "msg": "成功",
    "data": {
        "userId": "7180604901",    //用户编号
        "orderNo": "202504062042543583",   //订单号
        "energyAddress": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",  //能量地址
        "orderStatus": 2,  //订单状态：1：待支付  2：生效中  3：订单结束  4：暂停
        "proxyHash": "4420be367d46cd12413e822599db9e9d5530cf7b85cec932e8e07ad31bb5a946",  //代理hash
        "createTime": "2025-04-06 12:42:54",   //创建时间
        "resType": 1,   //资源类型：0：全部 1：ENERGY,:2：BANDWIDTH
        "minutes": 60   //有效期时间,单位：分钟
        "paymentType": 1,   //支付类型 1：trx支付  2：usdt支付
        "payAmount": 3,   //付款金额
        "trxAmount": 17926.355000,   //账户剩余trx余额
        "usdtAmount": 6622.309558   //账户剩余usdt余额
    }
}

小时闪租订单,（时长，闪租，指令，彩金，归集）

POST
/api/v2/hourlyFlashRentalOrder

请求参数(JSON 格式)

参数名称 类型 必需的 描述
address string 是 能量地址
energyNum integer 是 单次发送的能量 如32000/64000
resource String 是 资源类型 能量：ENERGY 宽带：BANDWIDTH 默认是 ENERGY
minutes integer 否 代理时间 基础单位：分钟 默认：60 分钟 (可不填)
secretKey string 是 用户API key

返回参数

参数名称 类型 描述
code integer 返回码，0表示成功，-1表示失败
msg string 返回信息
data object 返回数据

返回示例


{
    "code": 0,
    "msg": "成功",
    "data": {
        "userId": "7180604901",    //用户编号
        "orderNo": "202504062042543583",   //订单号
        "energyAddress": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",  //能量地址
        "orderStatus": 2,  //订单状态：1：待支付  2：生效中  3：订单结束  4：暂停
        "proxyHash": "4420be367d46cd12413e822599db9e9d5530cf7b85cec932e8e07ad31bb5a946",  //代理hash
        "createTime": "2025-04-06 12:42:54",   //创建时间
        "resType": 1,   //资源类型：0：全部 1：ENERGY,:2：BANDWIDTH 
        "minutes": 60   //有效期时间,单位：分钟
        "paymentType": 1,   //支付类型 1：trx支付  2：usdt支付
        "payAmount": 3,   //付款金额
        "trxAmount": 17926.355000,   //账户剩余trx余额
        "usdtAmount": 6622.309558   //账户剩余usdt余额
    }
}

速冲能量

POST
/api/v1/createQuickChargeOrders

请求参数

参数名称 类型 必需的 描述
address string 是 能量地址
energyNum integer 是 速冲数量(单次补充能量)
resource string 是 速冲资源类型 能量：ENERGY 宽带：BANDWIDTH 默认是 ENERGY
secretKey string 是 用户API key

返回参数

参数名称 类型 描述
code integer 返回码，0表示成功，-1表示失败
msg string 返回信息
data object 返回数据

返回示例


{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202504061926388936",    //订单编号
        "delegateHash": "1dc30293a7aa61062b7329654651deda7c3fe4dafdea394bf06a898332807124",  //代理hash
        "releaseHash": "0e5a3ad635895381c2c7e69bd1854cef2b8ed8276e482a68e96fa00ad04590f7",   //回收hash
        "energyNumber": 1000000,     //速冲数量
        "resource": "ENERGY",       //资源类型：0：全部 1：ENERGY,:2：BANDWIDTH
        "createTime": "2025-04-06 11:26:44"  //创建时间
    }
}

资金账户

GET
/api/v1/userAssets

请求参数

参数名称 类型 必需的 描述
secretKey string 是 用户API key

返回参数

参数名称 类型 描述
code integer 返回码，0表示成功，-1表示失败
msg string 返回信息
data object 返回数据

返回示例


{
    "code": 0,
    "msg": "成功",
    "data": {
        "userId": "7180604901",   //用户编号
        "userName": "@sxsxxsxsxsxs",   //用户飞机号
        "trxAmount": 1000017931.555000,  //trx 账户余额
        "usdtAmount": 9999996623.000000, // usdt 账户余额
        "rechargeAddress": "TTwoVzSYATvcFt6q99jTpX1dUHNYGaviNG",  //专属充值地址
        "createTime": "2024-08-22 06:45:03"  //注册时间
    }
}

订单查询

GET
/api/v1/queryOrder

请求参数

参数名称 类型 必需的 描述
secretKey string 是 用户API key
orderNo string 是 下单时返回的订单号

返回参数

参数名称 类型 描述
code integer 返回码，0表示成功，-1表示失败
msg string 返回信息
data object 返回数据

返回示例


{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202503121840454708",  //下单返回的订单编号
        "energyAddress": "TApnMaucHBp7hTpqS5Ttkake7JtLUec9gY",  //能量租赁地址
        "orderStatus": 3,   //1：待支付  2：生效中  3：订单结束  4：暂停
        "endTime": "2025-03-12 11:40:46",  //订单结束时间
        "hash": null,  //支付hash
        "releaseHash": "cc7a21cedc10f044b6779dab4aefefb6abd7c332648856e73b25801dbb714622",   //能量回收hash
        "proxyHash": "39d9a2f0febb2c488ff3921b730c0585bee75a1ccbfe8ffd1a1e599d4306e8d8",  //能量代理hash
        "flashType": 2,   //1：机器人充值 2: API 调用  3：快捷租赁
        "createTime": "2025-03-12 10:40:46",  //创建时间
        "paymentType": 2,   //支付类型 1：trx支付  2：usdt支付
        "resType": 1,   //资源类型：0：全部 1：ENERGY,:2：BANDWIDTH
        "minutes": 5,    //有效期时间 默认为分钟
        "payAmount": 0.074296,   //付款金额
        "trxAmount": 17926.355000,   //账户剩余trx余额
        "usdtAmount": 6622.309558   //账户剩余usdt余额
    }
}

获取池子资源

GET
/api/v1/poolResource

请求参数

参数名称 类型 必需的 描述
secretKey string 是 用户API key

返回参数

参数名称 类型 描述
code integer 返回码，0表示成功，-1表示失败
msg string 返回信息
data object 返回数据

返回示例


{
"code": 0,
"msg": "成功",
"data": {
    "totalEnergy": 7169877123,  //剩余总可用能量数量
    "totalBandwidth": 51618456  //剩余总可用宽带数量
  }
}