TRX.CEO Tron Energy
登录 联系客服
TRX.CEO API

波场能量租赁接口文档

面向代理和系统集成场景，提供账户查询、价格配置、能量下单和订单状态查询接口。所有金额字段默认以TRX计价，能量数量按实际下单数量传入。

BASE URL https://www.trx.ceo

接入流程

  1. 1 在会员中心完成注册并开启API权限
  2. 2 先调用价格配置接口确认当前单价、余额和最小下单数量
  3. 3 使用用户名密码版或APIKEY版接口提交能量租用订单
  4. 4 保存返回的orderId，并通过订单查询接口轮询发货状态
AUTH 用户名密码 / APIKEY
METHOD GET / POST
CONTENT TYPE form-data / x-www-form-urlencoded
GET / POST 账户 用户名

查询账户

根据用户名查询账户状态和TRX余额。

https://www.trx.ceo/api/v1/userInfo /api/v1/userInfo

请求参数

参数 必填 类型 示例 说明
username 是 string test 用户账号

响应字段

字段 类型 说明
code number 1表示请求成功
msg string 请求结果信息
data.username string 用户名
data.status string 用户状态，normal为正常，hidden为禁用
data.balance number 账户余额，单位TRX

请求示例

curl -X POST "https://www.trx.ceo/api/v1/userInfo" \
  -F "username=test"

成功响应

{
    "code": 1,
    "msg": "请求成功",
    "data": {
        "username": "test",
        "status": "normal",
        "balance": "100.000000"
    }
}
GET / POST 配置 用户名

查询价格和下单配置

获取用户当前余额、状态、可下单数量范围和能源价格配置。

https://www.trx.ceo/api/v1/config /api/v1/config

请求参数

参数 必填 类型 示例 说明
username 是 string test 用户账号

响应字段

字段 类型 说明
data.payConfig.ENERGY.canPay number 是否允许下单，1为可下单
data.payConfig.ENERGY.limit.min number 最小下单能量数量
data.payConfig.ENERGY.limit.usdt_min number USDT转账常用能量数量
data.payConfig.ENERGY.limit.max number 最大下单能量数量
data.payConfig.ENERGY.priceConfig.1 number 1小时能量单价，单位SUN
data.userInfo.balance number 当前账户余额，单位TRX

请求示例

curl -X POST "https://www.trx.ceo/api/v1/config" \
  -F "username=test"

成功响应

{
    "code": 1,
    "msg": "",
    "data": {
        "payConfig": {
            "ENERGY": {
                "canPay": 1,
                "limit": {
                    "min": 32000,
                    "usdt_min": 65000,
                    "max": 10000000
                },
                "priceConfig": {
                    "1": "44.687500"
                }
            }
        },
        "userInfo": {
            "username": "test",
            "state": "normal",
            "balance": "100.000000"
        }
    }
}
POST 下单 用户名 + 密码

租用资源下单用户名密码版

通过系统账号密码提交能量租用订单，适合服务端直接对接。

https://www.trx.ceo/api/v1/pay /api/v1/pay

请求参数

参数 必填 类型 示例 说明
username 是 string test 用户名
password 是 string test123456 用户密码
resType 是 string ENERGY 资源类型，目前使用ENERGY
payNums 是 number 65000 租用数量，不低于系统最小值
rentTime 是 number 1 租用时长，1表示1小时，24/72/720表示按天
resLock 是 number 0 资源是否锁定，0为不锁定，1为锁定
receiveAddress 是 string TUR3i6owz3iqqWpZkqANgEo4xCEFbD1CtQ 接收资源地址，请勿填写合约地址

响应字段

字段 类型 说明
data.hash string 资源代理交易Hash，未发货时可能为空
data.orderId string 平台订单号
data.balance number 下单后账户余额，单位TRX
data.orderMoney number 订单扣费金额，单位TRX

请求示例

curl -X POST "https://www.trx.ceo/api/v1/pay" \
  -F "username=test" \
  -F "password=test123456" \
  -F "resType=ENERGY" \
  -F "payNums=65000" \
  -F "rentTime=1" \
  -F "resLock=0" \
  -F "receiveAddress=TUR3i6owz3iqqWpZkqANgEo4xCEFbD1CtQ"

成功响应

{
    "code": 1,
    "msg": "下单成功",
    "data": {
        "hash": "",
        "orderId": "TRXCEO1714550400123456",
        "balance": "97.140000",
        "orderMoney": "2.860000"
    }
}
POST 下单 APIKEY

租用资源下单key版

通过会员中心生成的APIKEY提交订单，适合第三方系统长期集成。

https://www.trx.ceo/api/v1/payk /api/v1/payk

请求参数

参数 必填 类型 示例 说明
key 是 string keykeykeykeykeykeykey 会员中心生成的APIKEY
resType 是 string ENERGY 资源类型，目前使用ENERGY
payNums 是 number 65000 租用数量，不低于系统最小值
rentTime 是 number 1 租用时长，1表示1小时，24/72/720表示按天
resLock 是 number 0 资源是否锁定，0为不锁定，1为锁定
receiveAddress 是 string TUR3i6owz3iqqWpZkqANgEo4xCEFbD1CtQ 接收资源地址，请勿填写合约地址

响应字段

字段 类型 说明
data.hash string 资源代理交易Hash，未发货时可能为空
data.orderId string 平台订单号
data.balance number 下单后账户余额，单位TRX
data.orderMoney number 订单扣费金额，单位TRX

请求示例

curl -X POST "https://www.trx.ceo/api/v1/payk" \
  -F "key=keykeykeykeykeykeykey" \
  -F "resType=ENERGY" \
  -F "payNums=65000" \
  -F "rentTime=1" \
  -F "resLock=0" \
  -F "receiveAddress=TUR3i6owz3iqqWpZkqANgEo4xCEFbD1CtQ"

成功响应

{
    "code": 1,
    "msg": "下单成功",
    "data": {
        "hash": "",
        "orderId": "TRXCEO1714550400123456",
        "balance": "97.140000",
        "orderMoney": "2.860000"
    }
}
POST 订单 用户名 + 订单号

获取订单信息

根据订单号查询租用数量、接收地址、扣费金额和当前发货状态。

https://www.trx.ceo/api/v1/orderData /api/v1/orderData

请求参数

参数 必填 类型 示例 说明
username 是 string test 用户名
orderId 是 string TRXCEO1714550400123456 下单接口返回的平台订单号

响应字段

字段 类型 说明
data.canRenewals number 是否可续费，0为不可续费
data.lockTime number 租用秒数
data.orderId string 平台订单号
data.orderMoney number 订单消费，单位TRX
data.orderType string 资源类型，ENERGY为能量
data.payNums number 租用数量
data.receiveAddress string 接收资源地址
data.hash string 资源代理交易Hash
data.state string 待发货、已发货、已回收、已删除等状态

请求示例

curl -X POST "https://www.trx.ceo/api/v1/orderData" \
  -F "username=test" \
  -F "orderId=TRXCEO1714550400123456"

成功响应

{
    "code": 1,
    "msg": "",
    "data": {
        "canRenewals": 0,
        "lockTime": 3600,
        "orderId": "TRXCEO1714550400123456",
        "orderMoney": "2.860000",
        "orderType": "ENERGY",
        "payNums": 65000,
        "receiveAddress": "TUR3i6owz3iqqWpZkqANgEo4xCEFbD1CtQ",
        "hash": "",
        "state": "待发货"
    }
}

通用错误

code msg 说明
0 余额不足 / 密码错误 / 暂停下单 业务校验失败，msg会返回具体原因
10001 缺少用户名参数 必填参数为空或未传
10002 用户未找到 账号不存在或不可用
已复制