TRONow
語言 · 繁體中文
商戶後台 →
TRONow · 開發者

波場能量租賃 API 接入指南:簽章、下單與回呼

TRONow 波場能量 API 接入指南:最低 65K、即時報價、冪等下單、五種訂單狀態與 Webhook 驗簽。附公開 OpenAPI 規範與 Node.js 客戶端。

TRONow 審閱

開發者接入資料

公開接口規範與伺服器端參考客戶端,無需登入即可閱讀;實際調用 API 仍需已開通的商戶帳戶。

AI 接入 Skill ↓

OpenAPI 接口規範 · HTTP API

https://api.tronow.io/openapi/v1

HTTPAPI
GET/prices/quote
POST/orders
GET/orders
GET/orders/{order_id}
POST/address-activations
GET/address-activations
GET/address-activations/{activation_id}
GET/account/balance

錢包購買與商戶餘額

註冊商戶帳戶後,在商戶後台「充值」查看專屬 TRON 主網地址。僅支援原生 TRX,每筆至少 10 TRX,低於此金額不入帳。累計入帳達到 20 TRX 後,API 與商戶後台購買同時解鎖。充值僅增加餘額,不會自動建立能量訂單;每筆訂單仍需足夠的可用餘額。

最低 65K,先為準確數量取得報價

最低下單量為 65,000 Energy(65K)。API 報價及下單的 resource_amount 均須為不小於 65000 的整數,自訂數量同樣適用。32K、64K 等低於最低數量的請求回傳 422 UNSUPPORTED_PRODUCT,請修改數量後再請求。依準確的資源類型、數量及租期取得即時報價。回應包含 price_sun、currency 及 priced_at;price_sun 是整數 SUN 字串,用於顯示目前參考價,請勿寫死價格。POST /orders 受理時會重新計算並鎖定該筆訂單價格,不需提交報價編號。

每筆業務訂單只建立一次

建立訂單時提交資源類型、數量、租期、接收錢包及 client_order_id。同一業務請求使用相同 Idempotency-Key。受理回應包含平台訂單號與已鎖定的凍結金額;回應逾時後請以原始參數和冪等鍵重試或查詢訂單,不要只因回應遺失就用新鍵重複購買。

如何判斷能量訂單的五種狀態

HTTP 受理成功不代表能量已可用。請查詢訂單或處理驗簽後的 Webhook。CONFIRMING 已有雜湊,可在 TRONSCAN 查看;較穩妥的方式是等待 SUCCESS 或確認錢包可用能量後再轉帳。SUCCESS 表示已在 TRON 查到該雜湊,不代表後續 USDT 轉帳已成功。結果不確定時,請勿重複建立訂單。

API 狀態含義資金處理
PROCESSING處理中,尚無交易雜湊。凍結中
CONFIRMING已取得雜湊,正在非同步查詢鏈上交易。凍結中
SUCCESS已在 TRON 查到該雜湊。按鎖定訂單金額扣款
FAILED訂單處理失敗並結束。已釋放凍結金額
REVIEWING結果尚不確定,需要人工核查。繼續凍結,等待處理

保護憑證與回呼

API Secret 應保存在伺服器端,設定允許的來源 IP 並驗證 Webhook 簽名。日誌保留必要訂單識別,不記錄完整憑證。回呼可能重複投遞,接收方需實作冪等處理。

以帳戶實際報價評估

官網 API 參考價不代表所有帳戶擁有相同產品或價格。請以帳戶即時報價為準,先驗證完整訂單流程,再逐步擴大業務,並觀察餘額、失敗訂單及回呼。