資金流向（歷史）

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/HK.00700/capital-flow/history?period_type=DAY&start=2026-04-23&end=2026-05-23' | 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
  }
}