跳至主要内容

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"

建立即時連線​

使用 GET /kline/api/v1/kline/ws 建立 WebSocket 連線並訂閱即時推送。連線要求、訊息格式和訂閱範例見 介面詳情。

建議接入順序​

  1. 先用歷史 K 線介面載入頁面初始資料。
  2. 再建立 WebSocket 訂閱，刷新最新一根蠟燭。
  3. 斷線重連後，用歷史查詢補齊斷線期間缺口。