能量租賃 · 快速上手

下面兩條路互不相干：轉 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。

欄位、錯誤碼與完整回包見 接口。