API 文档

公开数据查询接口。所有请求需在 Header 中携带 X-API-Key 进行认证。

⚠ 认证说明
除首页、本页面外，所有接口均需要 X-API-Key 请求头。请联系管理员获取 API Key。

市场概览

GET/markets

获取所有市场的标的数、数据行数、日期范围。

# 示例：获取所有市场概览
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/markets"

GET/{market}/symbols

搜索/列出市场中的标的代码。

参数	类型	说明
market	path	市场：ashare / hkstock / usstock / indices / etfs
search	query	可选，模糊搜索代码（如 "600519"）
limit	query	返回条数，默认 50，最大 100
offset	query	分页偏移，默认 0

# 示例：搜索 A 股中包含 "600519" 的标的
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/symbols?search=600519&limit=10"

K 线数据

GET/{market}/klines/{symbol}

获取单标的日线 K 线数据，含 open/high/low/close/volume/amount，按日期倒序。

参数	类型	说明
market	path	ashare / hkstock / usstock / indices / etfs
symbol	path	标的代码，如 sh600519 / hk00700 / usAAPL
start	query	起始日期 YYYY-MM-DD（可选）
end	query	结束日期 YYYY-MM-DD（可选）
fields	query	返回字段：o/h/l/c/v/a 组合，如 "c,v"。默认全部（*）
limit	query	最大行数，默认 100
offset	query	分页偏移，默认 0

# 示例：取贵州茅台 2025 年全年日线
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/klines/sh600519?start=2025-01-01&end=2025-12-31&fields=c,v"

GET/{market}/klines

批量获取多标的 K 线数据（按套餐限制标的数：免费 5 只、专业/企业 50 只）。

参数	类型	说明
market	path	ashare / hkstock / usstock / indices / etfs
symbols	query	必填，逗号分隔的标的列表，如 sh600519,sz000858,sz000568
date	query	指定日期 YYYY-MM-DD（与 start/end 互斥）
start	query	起始日期（可选）
end	query	结束日期（可选）
fields	query	字段简写，如 "c,v"。默认 close,volume
limit	query	最大行数，默认 100

# 示例：查茅台和五粮液最近 5 个交易日收盘价+成交量
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/ashare/klines?symbols=sh600519,sz000858&limit=5&fields=c,v"

宏观经济

GET/macro

获取宏观经济数据序列：GDP / CPI&PPI / PMI。

参数	类型	说明
indicator	query	指标：gdp / cpi_ppi / pmi。不传返回全部
start	query	起始年份 YYYY（可选）
end	query	结束年份 YYYY（可选）
limit	query	最大行数，默认 100

# 示例：获取 2020-2025 年 GDP 数据
curl -H "X-API-Key: your-key" \
  "https://api.dataquant.trade/macro?indicator=gdp&start=2020&end=2025"

配额查询

GET/quota

查询当前 API Key 的套餐、日配额、今日已用量和剩余量。

数据覆盖速查

市场	路径	标的数	Symbol 示例
A 股	`ashare`	~3,505	`sh600519` · `sz000001`
港股	`hkstock`	500	`hk00700` · `hk09988`
美股	`usstock`	500	`usAAPL` · `usMSFT`
指数	`indices`	15	`sh000001` · `hkHSI`
ETF	`etfs`	11	`sh510050` · `sh510300`

字段说明

简写	全称	含义
`o`	open	开盘价
`h`	high	最高价
`l`	low	最低价
`c`	close	收盘价
`v`	volume	成交量（手）
`a`	amount	成交额

套餐限制

	免费版	专业版	企业版
日配额	5,000 行	200,000 行	2,000,000 行
速率	30 rpm	120 rpm	600 rpm
批量标的	5 只	50 只	50 只
单次行数	100	500	500