跳至主要内容

開始接入

Gel Labs 公開 API 覆蓋幣價、轉帳監聽、RPC 與 TRON 能量租賃。最快的開始方式:在 Console 建立 App,複製 API Key,發第一個請求。

取得 API Key​

  1. 打開 Console,用錢包登入。
  2. 建立一個 App。
  3. 在 App 詳情複製 API Key。只放在服務端,不要寫進前端或 App。
export API_KEY="your-api-key"

能量租賃:從錢包轉 TRX,以及公開詢價 GET|POST /energy-rental/trx-quote,都不需要 Key,見 能量租賃。RPC 用路徑裡的 endpoint token,也不帶 X-API-Key。

Base URL​

HTTPS https://gateway.gelabs.org
WSS wss://gateway.gelabs.org

認證​

多數 HTTP 接口只需要一個請求頭:

X-API-Key: your-api-key
產品怎麼認證
幣價、轉帳監聽、能量租賃 APIX-API-Key
RPCURL 裡的 {token},不要帶 X-API-Key

發第一個請求​

用幣價接口驗證 Key 是否可用(1 = BTC,1027 = ETH):

curl -H "X-API-Key: $API_KEY" \
"https://gateway.gelabs.org/market/api/v1/quotes/latest?ids=1,1027"

成功時 code 為 0,價格在 data.items。

回應格式​

除 RPC(上游 JSON-RPC)外,HTTP 成功體為:

{
"code": 0,
"message": "success",
"data": {}
}
欄位類型說明
codeinteger業務碼。成功固定 0
messagestring說明文字。成功常見 success 或 ok
dataobject / array / string / null業務資料。失敗時多為 "" 或 null

請用 code === 0 判斷成功,不要只看 HTTP 狀態碼。欄位名是 message,不是 msg。

產品​

產品做什麼入口
幣價按代幣 ID 或合約地址取即時報價/market/api/v1
轉帳監聽訂閱地址、查歷史、收即時推送/tx/api/v1、/tx/ws
RPCJSON-RPC HTTP / WebSocket/rpc/{network}/{token}
能量租賃租 1 小時 TRON 能量:轉 TRX 或調 API/energy-rental

選一個產品,打開它的「快速上手」。