GateData.AI
Complex Template · Historical Crypto Price Data

用例 3: 使用 GateData.AI API 获取历史价格数据

拉一段时间的 K 线数据，用来画图、跑回测或者算指标。

Use this template when
  • 要一段历史行情，而不是当前价格
  • 跑回测，或者算 MA、RSI、波动率
  • 把 K 线图嵌到自己的产品里
适用用户: 量化、图表产品、研究团队
输出预览静态样例，非实时
BTC · 1h · 100 bars68,412 → 69,120
OHLCV · missing points: 0

登录后可加载实时结果；当前为静态样例。

Run in Playground 在 MCP Playground 试跑 创建 API Key API Reference

API / MCP 调用

同一个模板同时支持 REST、Python 与 MCP Prompt。选择你熟悉的入口。

import requests

url = "https://api.gatedata.ai/api/v1/markets/kline?query=BTC&market=crypto&venue=gate&market_type=spot&quote=USDT&timeframe=1h&limit=100"
r = requests.get(url, headers={"Authorization": "Bearer gd_live_…"}, timeout=30)
r.raise_for_status()
bars = r.json().get("bars", [])
print(len(bars), bars[-1] if bars else None)

输入参数

修改下方参数，上方代码示例和请求 URL 会同步更新。Live 模板的默认值即可一键跑通。

GET/api/v1/markets/kline?query=BTC&market=crypto&venue=gate&market_type=spot&quote=USDT&timeframe=1h&limit=100

输出与解读

静态样例响应静态样例，非实时
{
  "asset": "BTC",
  "venue": "gate",
  "timeframe": "1h",
  "bars": [
    { "ts": 1751803200000, "o": 68120.1, "h": 68450.0, "l": 68010.5, "c": 68412.5, "v": 1523.4 }
  ],
  "missing_points": 0,
  "data_status": "ok",
  "metadata": {
    "data_status": "ready",
    "updated_at": "2026-07-06T12:00:00Z",
    "object_refs": [
      {
        "type": "asset",
        "id": "asset_btc",
        "asset_id": "asset_btc",
        "resolved_from": "params",
        "resolution_confidence": "explicit"
      },
      {
        "type": "listing",
        "id": "listing_gate_BTC_USDT_spot",
        "asset_id": "asset_btc",
        "instrument_id": "instrument_btc_usdt_spot",
        "listing_id": "listing_gate_BTC_USDT_spot",
        "venue_id": "venue_gate",
        "resolved_from": "params",
        "resolution_confidence": "explicit"
      }
    ]
  }
}
字段说明
  • timeframestring
    K 线粒度，例如 1h
  • bars[]array
    OHLCV 序列，按时间升序
  • bars[].o | h | l | c | vnumber
    开高低收与成交量
  • missing_pointsnumber
    缺失蜡烛数量，>0 说明该时段数据不连续
  • data_statusstring
    ok / partial / stale
  • metadata.object_refs[]object[]
    统一对象引用数组
  • object_refs[].typestring
    对象引用类型
  • object_refs[].idstring
    对象标识，标识 type 指定的具体对象
  • object_refs[].asset_idstring
    资产标识，标识股票、加密资产等资产对象
  • object_refs[].resolved_fromstring
    对象解析所用输入来源
  • object_refs[].resolution_confidencestring
    对象解析置信度
如何解读结果
  • 画图前先看 missing_points，大于 0 就说明数据有缺口
  • 回测按时间升序遍历 bars，别不小心用到未来的数据
  • 跨交易所对比，记得用同一个周期，并对齐时间戳

边界与下一步

Do NOT use for
  • 不适合毫秒级行情推送，那种用 WebSocket
  • 不返回订单簿
常见边界与状态
  • 免费额度覆盖最近 30 天，更长历史和批量导出需要付费
  • 小市值代币在部分交易所可能会返回 partial
查看最新价快照 打开 API Reference 查看订阅计划