跳到主要内容

K-Line API · 快速上手

快速接入流程​

开始前请先准备服务分配的 X-API-Key，并确认调用环境可以访问 https://api.gelabs.org。完整字段说明、WebSocket 协议和错误处理见 接口详情。

查询历史 K 线​

使用 GET /kline/api/v1/kline/ohlcv 加载初始蜡烛图数据：

curl -H "X-API-Key: $API_KEY" "https://api.gelabs.org/kline/api/v1/kline/ohlcv?interval=1h&from=1776679200&to=1776765600&limit=500&chain_type=evm&chain_id=1&pool_address=0xabc123def456&token=base"

建立实时连接​

使用 GET /kline/api/v1/kline/ws 建立 WebSocket 连接并订阅实时推送。连接要求、消息格式和订阅示例见 接口详情。

推荐接入顺序​

  1. 先用历史 K 线接口加载页面初始数据。
  2. 再建立 WebSocket 订阅，刷新最新一根蜡烛。
  3. 断线重连后，用历史查询补齐断线期间缺口。