跳到主要内容

开始接入

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

选一个产品,打开它的「快速上手」。