通用数据直查 GET /api/query Bearer
接口:query——通用直查通道,可查数据集持续增加:宏观(cpi/ppi/pmi/gdp/lpr/shibor/m1m2/社融)、资金流(fund_flow.daily 全市场日快照/mkt/sector/concept/ths_individual/ths_big_deal/ggt_top10/margin_secs)、行情粒度(minute1/minute5/minute15/minute30/minute60 全市场分钟bar、quote.auction 集合竞价)、龙虎榜(lhb_seats/lhb_yyb/top_inst)、可转债(cb_daily/issue/rating/jsl)、三大报表(statements.balance/profit/cashflow,EM口径)、公司治理(高管/股东增减持/十大流通股东/质押/回购/审计/调研/奖励)、基金(fund.basic/nav)、情绪(qspj/activity/hot_ths)、板块(board.zt_pools/limit_ladder/anomaly_reason)、元数据(new_share/namechange/hsgt_list/st_list/bse_mapping/suspend/disclosure/industry_pe/news/breadth/qvix/index.weight/主营构成/机构持股)等。统一按数据集名+代码+日期窗口查询,行数封顶,档位门槛按数据集设置。
限量:单次行数按档位上限(免费 200 ~ 旗舰 2000,默认 200):请求 limit 超出档位上限返回 422 并附上限数字,不做静默截断;响应带 total(过滤后总行数)与 truncated 标记。单日快照型数据集(资金流快照/涨停池/热榜等)截断取头部=榜单 Top-N;时间序列型(分钟线/逐股历史)取最近数据。无过滤参数时仅返回最新一个日期切片。行数计入日/月行数限额。参数白名单校验:传白名单外的参数名(如 trade_date)返回 422 并列出未知参数,不做静默忽略。
权限:各数据集独立档位(min_points 见档位表:免费 60+ 个,其余 1000~5000 分);限速按档位;每次调用按数据集计 1~10 点月配额。 档位说明 →
输入参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
dataset | str | 必填 | 数据集名,83 个可选,完整清单(含各自 min_points)见 GET /api/datasets / 数据集总表页;免费版常用:macro.cpi/ppi/pmi/gdp/lpr/shibor、derived.breadth、lhb_seats、basic.new_share、bond.cb_daily、moneyflow.mkt/sector/concept、corpus.news 等;1000分:board.zt_pools、sentiment.hot_rank;2000分:fund_flow.daily(全市场资金流快照)、quote.auction(竞价)、lhb_detail 等;5000分:minute1/minute5/minute15/minute30/minute60(分钟线)、valuation、moneyflow(个股/同花顺四件套)等。具体某集的档位以 /api/datasets 返回的 min_points 为准(本表仅示例) |
code | str | 见描述 | 股票代码;个股型数据集(fund_flow.daily/moneyflow/ths_individual/ths_big_deal/quote.auction/minute1/minute5/minute15/minute30/minute60/stk_limit/margin_detail/top_list/holdernumber/valuation/financial.audit/fund.nav 等)建议必填,市场型(macro.*/breadth/mkt/sector/concept/zt_pools)可省略;全市场扫描=固定日期(start=end)+分页拉取,单日全市场在 total 里可见 |
start | str | 选填 | 开始日期 YYYYMMDD 或 YYYY-MM-DD(含);分钟线支持多日窗口一次查询 |
end | str | 选填 | 结束日期(含);缺省=最新 |
limit | int | 选填 | 返回条数上限,默认 200;超出档位单次上限(免费200/基础300/标准500/专业1000/旗舰2000)返回 422 并附上限数字 |
输出参数
| 名称 | 类型 | 默认显示 | 描述 |
|---|---|---|---|
dataset | str | Y | 请求的数据集名 |
count | int | Y | 本次实际返回行数(≤limit) |
total | int | Y | 过滤后总行数(分页拉全量的依据;total>count 即被行数上限截断) |
truncated | bool | Y | 是否因行数上限截断(true=还有数据未返回) |
normalized | object | Y | 已数值化的列→单位映射(原'1.23亿'字符串列转为元数值,'0.62%'转为 0.62 百分数值) |
units | object | Y | 字段→单位口径(normalized 转换后的单位已并入) |
(随数据集) | - | Y | 每个数据集字段不同;如 fund_flow.daily 为全市场主力/超大/大/中/小单净额与净占比,moneyflow 为超大/大/中/小单买卖量额(THS口径),lhb_detail 为龙虎榜净买/买卖额与上榜后 N 日表现 |
units 口径随每个响应返回——消费方据此判 45 是 45% 还是 0.45,不必猜。
接口示例
curl -H "Authorization: Bearer <token>" "https://api-stock.600044.xyz/api/query?dataset=moneyflow&code=600519&limit=5"import requests
# 个股资金流:最近 5 个交易日
r = requests.get("https://api-stock.600044.xyz/api/query",
params={"dataset": "moneyflow", "code": "600519", "limit": 5},
headers={"Authorization": "Bearer <token>"}).json()
for row in r["rows"]:
print(row["trade_date"], "主力净额", row.get("buy_lg_amount", 0), "(THS 口径,units 为准)")数据样例 (真实数据:贵州茅台 600519)
dataset请求的数据集名 | count本次实际返回行数(≤limit) | total过滤后总行数(分页拉全量的依据;to | truncated是否因行数上限截断(true=还有数 | normalized已数值化的列→单位映射(原'1.23 | units字段→单位口径(normalized | rows |
|---|---|---|---|---|---|---|
| fund_flow.daily | 2 | 5907 | True | {} | {'主力净流入-净额': '元', '主力净流入-净占比': '百分比'} | [{'代码': '000001', '名称': '平安银行', '日期': '2026-09-22', '收盘价': 11.73, '涨跌幅': 0.26, '主力净流入-净额': 176339043.0, '主力净流入-净占比': 18.48}, {'代码': '000002', '名称': '万科Ａ', '日期': '2026-09-22', '收盘价': 3.65, '涨跌幅': 9.94, '主力净流入-净额': 486386960.0, '主力净流入-净占比': 15.16}] |
| moneyflow.ths_individual | 600519 | 20260922 | {'净额': '元', '成交额': '元', '涨跌幅': '百分比', '换手率': '百分比'} | [{'股票代码': 600519, '股票简称': '贵州茅台', '序号': 187, '最新价': 1271.01, '涨跌幅': -0.62, '净额': -80453200.0, '成交额': 2116621850.0}] |
表头第二行为字段含义(悬停无截断完整版见上方「输出参数表」);首列固定,横向滚动查看更多字段。
注意事项
- 全量扫描请按日期切片分页拉取(固定 start=end=某交易日);无过滤参数时只返回最新交易日(防误拉全表)。
- 盘后数据集(资金流/龙虎榜/涨跌停/涨停池/异动/竞价/热榜)为 T+1 节奏:盘中查询返回最近收盘快照;分钟线当日收盘后入库可查,当日盘中不可查。
- 资金流两套口径不可混用:moneyflow 族=THS 口径;fund_flow.daily/mkt/sector/concept=东财口径(主力=超大单+大单)。
- 金额列响应中已数值化:原'1.23亿/4567.89万'字符串→元数值,'0.62%'→0.62;normalized 字段列出已转换列,units 同步。
- 想看某数据集的字段口径与档位:左侧数据字典对应条目页。
← 返回接口列表 · 错误码:401 无效token / 403 需会员(该数据集基础档起) / 404 无数据 / 422 缺必填 / 429 限速或月配额 / 503 授权暂不可用(fail-closed)