開始接入
Gel Labs 公開 API 覆蓋幣價、轉帳監聽、RPC 與 TRON 能量租賃。最快的開始方式:在 Console 建立 App,複製 API Key,發第一個請求。
取得 API Key
- 打開 Console,用錢包登入。
- 建立一個 App。
- 在 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
| 產品 | 怎麼認證 |
|---|---|
| 幣價、轉帳監聽、能量租賃 API | X-API-Key |
| RPC | URL 裡的 {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": {}
}
| 欄位 | 類型 | 說明 |
|---|---|---|
code | integer | 業務碼。成功固定 0 |
message | string | 說明文字。成功常見 success 或 ok |
data | object / array / string / null | 業務資料。失敗時多為 "" 或 null |
請用 code === 0 判斷成功,不要只看 HTTP 狀態碼。欄位名是 message,不是 msg。
產品
| 產品 | 做什麼 | 入口 |
|---|---|---|
| 幣價 | 按代幣 ID 或合約地址取即時報價 | /market/api/v1 |
| 轉帳監聽 | 訂閱地址、查歷史、收即時推送 | /tx/api/v1、/tx/ws |
| RPC | JSON-RPC HTTP / WebSocket | /rpc/{network}/{token} |
| 能量租賃 | 租 1 小時 TRON 能量:轉 TRX 或調 API | /energy-rental |
選一個產品,打開它的「快速上手」。