查询 A 股股票资金流向（实时快照 / 15 分钟切片）

接口说明

项目	说明
接口名称	对外接口-查询股票资金流向
外部接口	GET /api/v1/market/data/stock-capital-flows
请求方式	GET
适用场景	分页查询 A 股股票资金流向；不传 date 返回当前实时快照，传入 date 可指定 15 分钟切片（默认 time=1530 日终）。仅返回 A 股（不含 ETF/指数），按主力净流入降序排列。

请求参数

参数名	类型	是否必填	描述	取值示例	备注
date	string	否	查询日期	20260616	格式 YYYYMMDD；不传=实时快照
time	string	否	15 分钟切片时刻	1530	格式 HHMM，分钟须为 00/15/30/45；仅与 date 同时有效，默认 1530（日终）
symbol	string	否	只查指定标的	601138.SH	外部格式（如 601138.SH）；逐页扫描定位，找到即停，返回其全市场排名与单条记录。不传则按分页/全量返回
page	int	否	页码	1	从 1 开始，默认 1
page_size	int	否	每页条数	50	默认 50

执行方式

# 当前实时快照（分页）
python scripts/handler.py --page 1 --page-size 50
# 历史 15 分钟切片（默认 time=1530 日终）
python scripts/handler.py --date 20260616 --page 1 --page-size 50
# 指定切片时刻（如 10:15）
python scripts/handler.py --date 20260616 --time 1015 --page 1 --page-size 50
# 全量自动翻页拉取某日日终资金流
python scripts/handler.py --date 20260616 --all
# 只查某只票某切片（逐页定位，返回排名+记录）
python scripts/handler.py --date 20260616 --symbol 601138.SH
# 只查某只票当前实时快照
python scripts/handler.py --symbol 601138.SH

响应结构

{
  "code": 200,
  "message": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 50,
    "total": 5209,
    "pages": 105,
    "records": [
      {
        "net_inflow_extra_large": "123456789.0000",
        "net_inflow_large": "98765432.1000",
        "net_inflow_main": "222222221.1000",
        "net_inflow_medium": "-50000000.0000",
        "net_inflow_small": "-172222221.1000",
        "symbol": "600000.SH",
        "symbol_name": "浦发银行",
        "ts_nanos": 1747037400000000000
      }
    ]
  }
}

--symbol 模式输出为定位结果：{"found": bool, "symbol": str, "rank": int|null, "total_items": int, "record": {...}}。

字段说明（CapitalFlowResponse）

字段名	类型	是否可为空	说明
net_inflow_extra_large	string	否	超大单净流入，单位元
net_inflow_large	string	否	大单净流入，单位元
net_inflow_main	string	否	主力净流入，单位元；公式 = 超大单净流入 + 大单净流入
net_inflow_medium	string	否	中单净流入，单位元
net_inflow_small	string	否	小单净流入，单位元
symbol	string	否	标的代码，外部格式如 600000.SH、000001.SZ
symbol_name	string	是	标的名称
ts_nanos	int	否	快照时间戳（纳秒）

注意事项

• 不传 date：返回当前实时资金流向快照。
• 传入 date：返回该日指定 15 分钟切片快照，默认 time=1530（日终）；time 分钟须为 00/15/30/45。
• 金额字段在 JSON 中以字符串形式返回（Decimal 序列化），单位元。
• symbol 为外部代码格式（如 600000.SH）。
• 仅返回 A 股股票（不含 ETF、指数等）；列表按 net_inflow_main 降序排列。
• 本接口响应带短期缓存（失败重试策略约 5 秒），相同 query 在缓存有效期内可能返回相同结果。
• --all 自动翻页拉取全量；全市场约 5000+ 条，按需使用以免响应过大。

调用示例

python <RUN_PY> stock-capital-flows --symbol 600519.SH