API 文档

基础地址 https://quantsonar.com · 全部接口为 GET · 认证请求头 X-API-Key · 免费获取 API Key →

# 快速开始：贵州茅台日线
curl "https://quantsonar.com/v1/market/daily?symbol=600519.SH&start_date=20260101" \
     -H "X-API-Key: qs_你的密钥"

# Python
import requests
rows = requests.get(
    "https://quantsonar.com/v1/market/daily",
    params={"symbol": "600519.SH", "start_date": "20260101"},
    headers={"X-API-Key": "qs_你的密钥"},
).json()

认证与限速

每个请求都需要请求头 X-API-Key。限速分三层：日配额（按订阅档位：FREE 100 / Starter 1,000 / PRO 3,000 / Expert 10,000 次/天）、每分钟突发上限（30 / 100 / 200 / 500 次/分钟），以及公平使用的每日流量上限（正常使用不会触碰）。每次响应都带 X-RateLimit-Limit / X-RateLimit-Remaining；超限返回 429（突发超限时带 Retry-After），次日自动恢复。

通用约定

约定	说明
symbol	证券代码统一带交易所后缀：`000001.SZ`、`600519.SH`、`430047.BJ`。裸代码返回 422。
日期	请求与响应统一 `YYYYMMDD`（如 `20260707`），与 Tushare 一致。
数值	价格、成交量等返回真正的 JSON 数值，不是字符串。
行数上限	无分页参数；每次调用按端点固定上限截断（常规 6000 行，财务类 20000 行），足够覆盖全市场单日切片。请用日期范围或过滤参数收窄。
错误	`401` 缺少/无效 Key · `422` 参数错误 · `429` 超限，响应体 `detail` 字段为中文说明。

行情数据

GET /v1/market/daily

日线行情（OHLC）

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/fundamentals

每日指标（PE/PB/换手率/市值）

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/adj-factor

复权因子

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/technical-factors

技术面因子

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/technical-factors-pro

技术面因子（专业版，含复权价+技术指标）

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/margin

融资融券明细

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/block-trade

大宗交易

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/top-list

龙虎榜（个股）

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/top-inst

龙虎榜（机构席位）

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/shareholders

股东户数

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
enddate	统计截止日 YYYYMMDD
ann_date	公告日期 YYYYMMDD

GET /v1/market/holder-trade

重要股东增减持

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_type	增减持方向：IN 增持 / DE 减持
holder_type	股东类型：G 高管 / P 个人 / C 公司

GET /v1/market/limit-list

涨跌停榜单

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
limit_type	涨跌停类型：U 涨停 / D 跌停 / Z 炸板
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/market/concepts

概念/题材板块指数

参数	说明
symbol	代码原样匹配（板块/外汇/港股等）
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）
name	名称精确匹配
idx_type	板块类型

GET /v1/market/concept-members

概念/题材板块成分股

参数	说明
symbol	代码原样匹配（板块/外汇/港股等）
con_symbol	成分股代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

资金流向

GET /v1/flows/moneyflow

个股资金流向

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/flows/moneyflow-hsgt

沪深港通资金流向（全市场）

参数	说明
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/flows/northbound-holdings

北向持股明细

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/flows/southbound-holdings

南向（港股通）持股明细

参数	说明
symbol	代码原样匹配（板块/外汇/港股等）
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

筹码分布

GET /v1/chips/distribution

筹码分布与胜率

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

指数

GET /v1/indices/daily

指数日线（默认上证综指）

参数	说明
symbol	指数代码（带后缀），如 000300.SH；缺省 000001.SH
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

GET /v1/indices/index-weight

指数成分与权重

参数	说明
symbol	指数代码（带后缀），如 000300.SH
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

财务数据

GET /v1/financials/indicators

财务指标

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）
ann_date	公告日期 YYYYMMDD

GET /v1/financials/income

利润表

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）
ann_date	公告日期 YYYYMMDD
f_ann_date	实际公告日期 YYYYMMDD
report_type	报表类型（Tushare 口径：1 合并报表 / 6 母公司报表 …）
comp_type	公司类型（1 一般工商业 / 2 银行 / 3 保险 / 4 证券）

GET /v1/financials/balance-sheet

资产负债表

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）
ann_date	公告日期 YYYYMMDD
report_type	报表类型（Tushare 口径：1 合并报表 / 6 母公司报表 …）
comp_type	公司类型（1 一般工商业 / 2 银行 / 3 保险 / 4 证券）

GET /v1/financials/cash-flow

现金流量表

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）
ann_date	公告日期 YYYYMMDD
f_ann_date	实际公告日期 YYYYMMDD
report_type	报表类型（Tushare 口径：1 合并报表 / 6 母公司报表 …）
comp_type	公司类型（1 一般工商业 / 2 银行 / 3 保险 / 4 证券）

GET /v1/financials/forecast

业绩预告

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）
type	业绩预告类型（预增/预减/扭亏/首亏等）

GET /v1/financials/express

业绩快报

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）

GET /v1/financials/analyst-reports

券商研报盈利预测

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD

GET /v1/financials/audit

财务审计意见

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）
ann_date	公告日期 YYYYMMDD

GET /v1/financials/main-business

主营业务构成

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
period	报告期 YYYYMMDD（如 20251231 = 2025 年报）

GET /v1/financials/disclosure-date

财报披露日历

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
pre_date	预计披露日 YYYYMMDD
actual_date	实际披露日 YYYYMMDD

分红送股

GET /v1/shareholders/dividend

分红送股

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
record_date	股权登记日 YYYYMMDD
ex_date	除权除息日 YYYYMMDD
imp_ann_date	实施公告日 YYYYMMDD

外汇

GET /v1/fx/daily

外汇日线（默认 USDCNH）

参数	说明
symbol	代码原样匹配（板块/外汇/港股等）；缺省 USDCNH.FXCM
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
trade_date	单个交易日 YYYYMMDD（与 start/end 二选一）

基础信息

GET /v1/reference/stocks

股票列表

参数	说明
symbol	证券代码（带后缀），如 000001.SZ
name	名称精确匹配
market	市场类别（主板/创业板/科创板/北交所）
list_status	上市状态：L 上市 / D 退市 / P 暂停上市
exchange	交易所：SSE 上交所 / SZSE 深交所
is_hs	是否沪深港通标的：N 否 / H 沪股通 / S 深股通

GET /v1/reference/industries

申万行业分类

参数	说明
symbol	证券代码（带后缀），如 000001.SZ

GET /v1/reference/trade-calendar

交易日历（默认上交所）

参数	说明
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
exchange	交易所：SSE 上交所 / SZSE 深交所
is_open	是否交易日：1 是 / 0 否

实时与快讯

GET /v1/market/realtime

实时行情快照

每只证券的最新盘中快照，交易时段持续刷新；非交易时段返回上一交易日收盘快照。

参数	说明
symbol	证券代码，逗号分隔可批量（至多 200 个）；不传返回全市场

GET /v1/news/flash

财经快讯（实时）

实时财经快讯，三个独立来源：cls（财联社）/ jin10（金十）/ sina（新浪）。按发布时间倒序，延迟约 60 秒。

参数	说明
source *	快讯来源：cls / jin10 / sina
start_date	起始日期 YYYYMMDD
end_date	结束日期 YYYYMMDD
importance	仅返回重要度 ≥ 此值的快讯（1 = 仅重要）