指南

指南

围绕常见任务的实用 how-to,覆盖 Crypto 与美股。每个示例都可直接复制运行。

如何快速上手

我的账户 生成 API Key(形如 gd_live_…),所有请求都通过 Authorization: Bearer 请求头鉴权。基址为 https://api.gatedata.ai。下面是你的第一次调用——无需 API Key 即可在样例标的上运行:

cURL
curl "https://api.gatedata.ai/api/v1/markets/snapshot?query=BTC&market=crypto" \
  -H "Authorization: Bearer gd_live_…"
# { "price": 64210.50, "price_change_24h": 2.41, ... }

如何获取股票价格

同一个 /api/v1/markets/snapshot 接口同时支持 Crypto 与美股——把 query 换成股票代码即可。需要历史走势时改用 /api/v1/markets/kline

cURL
curl "https://api.gatedata.ai/api/v1/markets/snapshot?query=AAPL&market=us_equity" \
  -H "Authorization: Bearer gd_live_…"
# { "price": 311.97, "day_volume": 1, "metadata": { "data_status": "partial", "object_refs": [], "limitations": ["listing_id_unavailable_source_code_only"] } }