Tron Energy API 文档

准备工作

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

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

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

接口约定

请求域名

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  //剩余总可用宽带数量
  }
}

笔数管理

笔数管理接口用于管理能量地址的笔数订单，包括新增、增加、减少、查询、开启、关停，以及笔数账单（汇总消耗与余额、按地址统计、消耗明细分页）。

新增笔数订单

POST

/api/v2/countOrder/create

请求参数(JSON 格式)

参数名称	类型	必需的	描述
address	string	是	能量地址（34位TRON地址，以T开头）
quantity	integer	是	笔数（必须大于0）
secretKey	string	是	用户API key

返回参数

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

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202504062042543583",
        "address": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
        "quantity": 100,
        "remainingQuantity": 98
    }
}

增加笔数

POST

/api/v2/countOrder/increase

请求参数(JSON 格式)

参数名称	类型	必需的	描述
address	string	是	能量地址（34位TRON地址，以T开头）
quantity	integer	是	增加的笔数（必须大于0）
secretKey	string	是	用户API key

返回参数

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

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202504062042543583",
        "address": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
        "quantity": 10,
        "beforeQuantity": 98,
        "afterQuantity": 108
    }
}

减少笔数

POST

/api/v2/countOrder/decrease

请求参数(JSON 格式)

参数名称	类型	必需的	描述
address	string	是	能量地址（34位TRON地址，以T开头）
quantity	integer	是	减少的笔数（必须大于0，支持负数结果）
secretKey	string	是	用户API key

返回参数

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

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202504062042543583",
        "address": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
        "quantity": 10,
        "beforeQuantity": 108,
        "afterQuantity": 98
    }
}

查询笔数订单

POST

/api/v2/countOrder/query

请求参数(JSON 格式)

参数名称	类型	必需的	描述
address	string	是	能量地址（34位TRON地址，以T开头）
secretKey	string	是	用户API key

返回参数

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

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202504062042543583",
        "address": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
        "quantity": 100,
        "remainingQuantity": 98,
        "orderStatus": 2,
        "orderStatusText": "生效中",
        "energyRemaining": 5000000,
        "bandwidthRemaining": 1000000,
        "createTime": "2025-04-06 12:42:54",
        "updateTime": "2025-04-06 12:42:54"
    }
}

笔数账单

根据 secretKey 解析当前用户与机器人（bot），返回汇总与每笔消耗明细。明细数据来自表 energy_count_order_usage；今日/昨日消耗按数据库自然日（与后台看板 DATE(create_time) 口径一致）。

POST

/api/v2/countOrder/bill

请求参数(JSON 格式)

参数名称	类型	必需的	描述
secretKey	string	是	用户 API key，用于定位资产账户及 userId / botId
beginTime	string	否	明细筛选开始时间，格式 `yyyy-MM-dd HH:mm:ss`；须与 `endTime` 同时传入或同时省略
endTime	string	否	明细筛选结束时间，格式同上；闭区间筛选 `create_time`
pageNum	integer	否	明细页码，默认 1
pageSize	integer	否	每页条数，默认 20，最大 100

返回参数（data 结构）

参数名称	类型	描述
code	integer	返回码，0 表示成功，-1 表示失败
msg	string	返回信息
data.summary	object	汇总：今日/昨日总使用笔数、账户总剩余笔数、TRX/USDT 余额、userId、botId、按能量地址拆分的统计列表
data.summary.todayTotalUseCount	integer	当前用户在该 bot 下今日总消耗笔数（自然日）
data.summary.yesterdayTotalUseCount	integer	昨日总消耗笔数（自然日）
data.summary.accountTotalRemainingQuantity	integer	账户总剩余笔数：各能量地址在订单状态为「生效中(2)」或「暂停(4)」下取最新一条订单的剩余笔数后求和
data.summary.trxBalance	number	账户 TRX 余额（来自资金账户）
data.summary.usdtBalance	number	账户 USDT 余额（来自资金账户）
data.summary.addresses	array	按能量地址：每项含 energyAddress、todayUseCount、yesterdayUseCount、remainingQuantity（仅有订单无消耗记录时今日/昨日可为 0）
data.detailPage	object	消耗明细分页：total、pageNum、pageSize、records
data.detailPage.records[]	object	单条消耗：id、orderNo、energyAddress、txHash、trxAmount、energyUsage、useCount、beforeQuantity、afterQuantity、countType、deductTrxAmount、createTime、remark

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "summary": {
            "todayTotalUseCount": 12,
            "yesterdayTotalUseCount": 8,
            "accountTotalRemainingQuantity": 500,
            "trxBalance": 100.5,
            "usdtBalance": 0,
            "userId": "user_001",
            "botId": 1,
            "addresses": [
                {
                    "energyAddress": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
                    "todayUseCount": 10,
                    "yesterdayUseCount": 5,
                    "remainingQuantity": 300
                },
                {
                    "energyAddress": "TN8zhDmWp21AqCZpYAP8e1ZpWQMKHUwBZm",
                    "todayUseCount": 2,
                    "yesterdayUseCount": 3,
                    "remainingQuantity": 200
                }
            ]
        },
        "detailPage": {
            "total": 156,
            "pageNum": 1,
            "pageSize": 20,
            "records": [
                {
                    "id": 1001,
                    "orderNo": "202504062042543583",
                    "energyAddress": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
                    "txHash": "a1b2c3d4e5f6...",
                    "trxAmount": 1.2,
                    "energyUsage": 65000,
                    "useCount": 1,
                    "beforeQuantity": 301,
                    "afterQuantity": 300,
                    "countType": 1,
                    "deductTrxAmount": 0,
                    "createTime": "2025-04-06 14:30:00",
                    "remark": null
                }
            ]
        }
    }
}

说明：仅传 secretKey 时明细为全部历史记录分页；传时间时 beginTime 不得晚于 endTime。secretKey 无效时与其它接口一致返回失败。

开启笔数订单

POST

/api/v2/countOrder/enable

请求参数(JSON 格式)

参数名称	类型	必需的	描述
address	string	是	能量地址（34位TRON地址，以T开头）
secretKey	string	是	用户API key

返回参数

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

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202504062042543583",
        "address": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
        "oldStatus": 4,
        "newStatus": 2,
        "oldStatusText": "暂停",
        "newStatusText": "生效中"
    }
}

关停笔数订单

POST

/api/v2/countOrder/disable

请求参数(JSON 格式)

参数名称	类型	必需的	描述
address	string	是	能量地址（34位TRON地址，以T开头）
secretKey	string	是	用户API key

返回参数

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

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "orderNo": "202504062042543583",
        "address": "THGurvTsqd3ybhyZXJcJ87cVtj5mDN5655",
        "oldStatus": 2,
        "newStatus": 4,
        "oldStatusText": "生效中",
        "newStatusText": "暂停"
    }
}