资金流向（历史）

GET /v1/quote/{symbol}/capital-flow/history

获取个股历史资金流入流出（日 / 周 / 月级聚合）。返回每个数据点的整体净流入、主力净流入、按订单大小（特大单 / 大单 / 中单 / 小单）分档的净流入，以及主力成交占比与累计主力净流入。

请求参数

参数	类型	位置	必填	说明
symbol	string	路径	是	股票代码，MARKET.CODE 格式，例 HK.00700 / US.AAPL / SZ.000001。
period_type	string	查询	否	聚合周期，默认 DAY。详见命名词典。
start	string	查询	否	起始日期 yyyy-MM-dd（含），不传则不限下界。
end	string	查询	否	结束日期 yyyy-MM-dd（含），不传则取当日。
count	int	查询	否	最大返回数据点数，范围 1~1000，默认 365。

请求示例

curl '$ip/v1/quote/US.AAPL/capital-flow/history?period_type=DAY&start=2026-04-23&end=2026-05-23&count=5' | jq
curl '$ip/v1/quote/HK.00700/capital-flow/history?period_type=WEEK&count=4' | jq

响应字段

顶层 data：

字段	类型	说明
flow_list	array	数据点列表，按时间升序；标的合法但当前无数据时为空数组。

顶层 pagination：

字段	类型	说明
has_more	bool	是否还有更早的数据可继续翻页（向更早方向翻）。

flow_list[i]：

字段	类型	说明
capital_flow_item_time	int64	数据时间点（毫秒时间戳，按 period_type 对齐到日 / 周 / 月）。
in_flow	double	整体净流入（标的本币元；正 = 净流入，负 = 净流出）。
main_in_flow	double	主力净流入（特大 + 大单合计）。
super_in_flow	double	特大单净流入。
big_in_flow	double	大单净流入。
mid_in_flow	double	中单净流入。
sml_in_flow	double	小单净流入。
main_deal_ratio	double	主力成交占比（0.123 = 12.3%）；后端按需下发，缺省时该字段省略。
acc_main_in_flow	double	累计主力净流入；后端按需下发，缺省时该字段省略。

限制范围

维度	支持	不支持 / 当前无数据
市场（正股 / ETF）	HK · US · SH · SZ · SG · JP · CA · AU	KR · MY · BJ（部分代码可解析但当前无资金流向数据）
品类	正股、ETF	指数、窝轮（标的合法但 flow_list 始终为空）；期权 / 期货 / 数字货币（不支持）
时间范围	日 / 周 / 月聚合，可指定 start / end 区间	当日分钟级请用资金流向（日内）接口
翻页	通过 pagination.has_more + 调整 end 向更早翻页	—

当标的合法但当前无资金流向数据（窝轮 / 指数 / 停牌 / 上市前 / 区间内无交易），返回 ret_code=0、flow_list=[]、pagination.has_more=false。

错误码

ret_code	error.code	触发场景	调用方处理建议
0	—	成功（含合法标的但当前无数据，flow_list=[]）	通过 flow_list 长度判断是否有数据
-3	invalid_parameter	symbol 不符合 MARKET.CODE 格式 / period_type 不在 DAY/WEEK/MONTH 内 / start 或 end 不是合法日历日期 / count 越界	校验入参后重试
-7	invalid_symbol	标的格式合法但在证券缓存中查不到（不存在 / 拼写错误 / 当前未支持的市场如 KR / MY）	检查 symbol 是否真实存在
-8	unsupported	后端明确返回市场不支持资金流向历史	改用支持市场的标的

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "flow_list": [
      {
        "capital_flow_item_time": 1776873600000,
        "in_flow": 200218920,
        "main_in_flow": 24536730,
        "super_in_flow": 6079988.56,
        "big_in_flow": 23699631.17,
        "mid_in_flow": 21197077.81,
        "sml_in_flow": -11104470.93,
        "main_deal_ratio": 0.2259
      }
    ]
  },
  "pagination": {
    "has_more": false
  }
}