开始接入
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 |
选一个产品,打开它的「快速上手」。