能量租赁 · 快速上手

下面两条路互不相干：转 TRX 可以先调公开询价，不必注册、不必 API Key；积分下单才要 Key，且不必转 TRX。

转 TRX 购买

适合钱包或自己组转账。系统在收到原生 TRX 后，把能量代理到付款地址。

1. 询价：该转多少 TRX

公开接口，不要带 X-API-Key。传入需要的能量，返回应付 TRX 和收款地址。询价本身不转账、不扣积分。

curl "https://gateway.gelabs.org/energy-rental/trx-quote?energyAmount=80000"

服务端也可以 POST：

curl -X POST \
  -H "Content-Type: application/json" \
  https://gateway.gelabs.org/energy-rental/trx-quote \
  -d '{"energyAmount":80000}'

成功时 code 为 0：

{
  "code": 0,
  "message": "success",
  "data": {
    "energyAmount": 80000,
    "trxAmount": 8,
    "energyGranted": 131000,
    "payAddress": "TEtK5Gfm24Bp3yc6LomkZGqr1wQrTE7Gx2",
    "durationHours": 1
  }
}

字段	你拿来做什么
trxAmount	转出这么多原生 TRX
energyGranted	实际会到账的能量（可能多于你要的）
payAddress	收款地址，转到这里

energyAmount 必须大于 0。非法参数返回 HTTP 400 / code=10001。完整字段见 接口。

到账规则（中间金额向下靠档；自己估算时向上取档）：

转出 TRX	得到的能量	说明
少于 4	不租，TRX 留下	—
4	65,000
8	131,000	特例，不是 130,000
4n（n ≥ 3）	65000 × n	12 → 195,000；16 → 260,000

2. 转原生 TRX

打开 TronLink 或其他 TRON 钱包，转 原生 TRX（不要转 USDT / TRC-20）：

• 金额：上一步的 trxAmount（示例是 8）
• 收款地址：上一步的 payAddress

TEtK5Gfm24Bp3yc6LomkZGqr1wQrTE7Gx2

3. 确认到账

一般数秒内到账。没有订单号，也没有查单接口。到 TronScan 打开付款地址（谁转出去，能量就打给谁），看 Energy 是否增加。时长 1 小时，到账后不能退款。

用积分 API 购买

适合要在自己的服务里自动租能量的开发者。

准备

1. 在 Console 建立 App。

2. 为该 App 开通能量租赁。

3. 复制 API Key，放到服务端：

   export API_KEY="your-api-key"

4. 确保 App 积分 / USDT 足够。不够时询价会返回 sufficient: false。

Base URL 与认证

https://gateway.gelabs.org

每个请求带：

X-API-Key: your-api-key
Content-Type: application/json

JSON 字段是 camelCase。成功看信封里的 code === 0。

1. 积分询价（不扣费）

能量至少 65000。看 data.sufficient，为 false 时先充值，不要下单。

curl -X POST \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  https://gateway.gelabs.org/energy-rental/quote \
  -d '{"energyAmount":65000,"receiverAddress":"TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf"}'

2. 下单

receiverAddress 是能量打到的 TRON 地址（Base58，T 开头）。Idempotency-Key 自己生成；同一笔请求超时重试必须用同一把。

IDEMPOTENCY_KEY=$(uuidgen)

curl -X POST \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  https://gateway.gelabs.org/energy-rental/orders \
  -d '{"energyAmount":65000,"receiverAddress":"TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf"}'

同一 Key 且地址、能量相同：返回原单，不会再扣一次。
同一 Key 但地址或能量变了：冲突。
再租一次：换新的 Idempotency-Key。

3. 查单，直到成功

路径里的单号是下单返回的 orderNo。

curl -H "X-API-Key: $API_KEY" \
  https://gateway.gelabs.org/energy-rental/orders/ER_20260915120000_123456

status	含义	你要做的
PROCESSING	处理中，积分已预留尚未实扣	过几秒再查
SUCCESS	能量已代理到 receiverAddress	可以发链上交易
FAILED	失败，预留已释放	看 failReason，必要时换新 Key 重下

SUCCESS 时也可用 TronScan 核对接收地址的 Energy。

字段、错误码与完整回包见 接口。