datasource_matrix.md

数据源能力矩阵

自动生成，请勿手动编辑。更新请运行 /update-datasource-matrix。

表1: 数据源总览

数据源	优先级	A股	港股	美股	日线	实时行情	基本面	财务数据	备注
EfinanceFetcher	P0	✅	❌	❌	✅	✅	❌	❌	东方财富，A股首选
AkshareFetcher	P1	✅	✅	❌	✅	✅	❌	❌	多源切换（EM/Sina/腾讯），港股日线+行情
TushareFetcher	P2	✅	❌	❌	✅	✅	❌	❌	需 Token，配置后优先级提升至 P-1
PytdxFetcher	P2	✅	❌	❌	✅	✅	❌	❌	通达信公共服务器，连接不稳定
BaostockFetcher	P3	✅	❌	❌	✅	❌	❌	❌	证券宝，仅日线
XueqiuFetcher	P3	✅	✅	✅	✅	✅	✅	✅	全市场覆盖，美股数据最全
YfinanceFetcher	P4	✅	✅	✅	✅	✅	❌	❌	Yahoo Finance，美股兜底，易限流
TwelveDataFetcher	P5	✅	✅	✅	✅	❌	❌	❌	需 API Key，无 Key 时 P999 禁用
OpenBBFetcher	P3	❌	✅	✅	✅	❌	✅	✅	OpenBB Platform，美/港增强（分析师评级/关键指标/收益日历/财务报表），需配置 provider
TickFlowFetcher	P99	✅	❌	❌	❌	❌	❌	❌	仅用于大盘综述，不参与个股数据获取

表2: 美股/港股数据源详细能力

能力	XueqiuFetcher	YfinanceFetcher	TwelveDataFetcher	AkshareFetcher	OpenBBFetcher
覆盖市场	美股+港股	美股+港股	美股+港股	港股	美股+港股
日线 OHLCV	✅	✅	✅	✅(港股)	✅
日线估值列(PE/PB/PS)	✅	❌	❌	❌	❌
实时价格	✅	✅(Stooq兜底)	❌	✅(港股)	❌
PE/PB	✅	❌	❌	✅(港股)	❌
总市值	✅	✅(仅美股)	❌	✅(港股)	❌
流通市值	⚠️(美股为空)	❌	❌	✅(港股)	❌
量比	✅	❌	❌	✅(港股)	❌
换手率	✅	❌	❌	✅(港股)	❌
52周高低	✅	❌	❌	✅(港股)	❌
经营现金流	✅	❌	❌	❌	❌
投资/筹资现金流	✅	❌	❌	❌	❌
资产负债表	✅	❌	❌	❌	❌
财务指标(毛利率/净利率等)	✅	❌	❌	❌	❌
行业概念	✅	❌	❌	❌	❌
资金流向	✅	❌	❌	❌	❌
公司简介	✅(via AkShare)	❌	❌	❌	❌
分析师评级	❌	❌	❌	❌	✅
收益日历	❌	❌	❌	❌	✅
关键指标	❌	❌	❌	❌	✅
财务报表	❌	❌	❌	❌	✅

表3: 路由优先级

日线数据

市场	路由顺序
A股	按优先级遍历全部数据源：EfinanceFetcher → AkshareFetcher → TushareFetcher → PytdxFetcher → BaostockFetcher → XueqiuFetcher → YfinanceFetcher → TwelveDataFetcher
港股	同 A 股路由（AkshareFetcher 支持港股日线）
美股	仅路由到 _US_FETCHER_NAMES：XueqiuFetcher(P3) → OpenBBFetcher(P3) → YfinanceFetcher(P4) → TwelveDataFetcher(P5)

实时行情

市场	路由顺序
A股	按配置优先级：tencent → akshare_sina → efinance → akshare_em（首个成功后尝试补充字段）
港股	AkshareFetcher(source=hk) → XueqiuFetcher(兜底)
美股	XueqiuFetcher(优先) → YfinanceFetcher(兜底，含 Stooq 二次兜底)
美股指数	XueqiuFetcher(优先) → YfinanceFetcher(兜底)

基本面数据

市场	数据源	数据块
A股	AkshareFundamentalAdapter	growth / earnings(预告+快报) / valuation / institution / capital_flow / dragon_tiger / dividend
美股	UsStockFundamentalAdapter	growth + earnings(东方财富) → valuation(百度PE) → company_profile(雪球AkShare) → 雪球增强(现金流/资产负债表/财务指标/行业概念/资金流向)
港股	不支持	—

表4: 雪球 API 端点明细

端点	用途	需要 Token	返回数据
xueqiu.com/	Cookie 初始化	—	基础 Cookie
xueqiu.com/snowman/login/init	获取匿名 Token	—	xq_a_token Cookie
stock.xueqiu.com/v5/stock/chart/kline.json	日线数据	✅	OHLCV + PE/PB/PS/PCF/市值/换手率
stock.xueqiu.com/v5/stock/quote.json	完整实时行情	✅	价格/涨跌/量比/换手率/PE/PB/市值/流通市值/52周高低/EPS/每股净资产
stock.xueqiu.com/v5/stock/realtime/quotec.json	轻量实时行情	❌	价格/涨跌/成交量/换手率/市值（无PE/PB）
stock.xueqiu.com/v5/stock/finance/{mkt}/cash_flow.json	现金流量表	✅	经营/投资/筹资现金流、折旧摊销、期末现金
stock.xueqiu.com/v5/stock/finance/{mkt}/balance.json	资产负债表	✅	总资产/总负债/股东权益/现金/长期债务/商誉/存货/应收/留存收益
stock.xueqiu.com/v5/stock/finance/{mkt}/indicator.json	财务指标	✅	EPS/每股净资产/ROE/毛利率/净利率/资产负债率/流动比率/速动比率/周转率
stock.xueqiu.com/v5/stock/f10/{mkt}/industry.json	行业概念	✅	所属概念板块列表、行业分类
stock.xueqiu.com/v5/stock/capital/assort.json	资金流向	✅	大单/中单买卖金额

{mkt} 路径：A股=cn，港股=hk，美股=us

表5: 实时行情字段覆盖

字段	EfinanceFetcher	AkshareFetcher(EM)	AkshareFetcher(腾讯)	AkshareFetcher(港股)	XueqiuFetcher(quote)	XueqiuFetcher(quotec)	YfinanceFetcher	TushareFetcher
价格	✅	✅	✅	✅	✅	✅	✅	✅
涨跌幅	✅	✅	✅	✅	✅	✅	✅	✅
成交量	✅	✅	✅	✅	✅	✅	✅	✅
成交额	✅	✅	✅	✅	✅	✅	❌	✅
量比	✅	✅	✅	✅	✅	❌	❌	❌
换手率	✅	✅	✅	✅	✅	✅	❌	✅
振幅	❌	✅	✅	✅	✅	✅	❌	❌
PE(动态)	✅	✅	✅	✅	✅	❌	❌	✅
PB	❌	✅	✅	✅	✅	❌	❌	✅
总市值	✅	✅	✅	✅	✅	✅	✅(美股)	✅
流通市值	✅	✅	✅	✅	⚠️	❌	❌	❌
52周高低	❌	✅	❌	✅	✅	❌	❌	❌
60日涨跌幅	❌	✅	❌	❌	❌	❌	❌	❌

表6: 增强数据服务 (src/services/)

以下服务提供核心数据源之外的补充数据维度：

us_macro_service.py — 美股宏观环境

• 12 项指标并行抓取
• 双层缓存：慢层（24h SQLite 持久化）+ 快层（4h 内存）
• 线程安全 fetch lock，防止重复并发请求

数据	API/来源	缓存层	市场
美联储利率	akshare macro_bank_usa_interest_rate	慢(24h)	美股
CPI同比	akshare macro_usa_cpi_yoy	慢(24h)	美股
失业率	akshare macro_usa_unemployment_rate	慢(24h)	美股
非农就业	akshare macro_usa_non_farm	慢(24h)	美股
ISM制造业PMI	akshare macro_usa_ism_pmi	慢(24h)	美股
消费者信心指数	akshare macro_usa_michigan_consumer_sentiment	慢(24h)	美股
初请失业金	akshare macro_usa_initial_jobless	慢(24h)	美股
美债收益率(10Y/2Y)	akshare bond_zh_us_rate	慢(24h)	美股
VIX恐慌指数	akshare stock_us_daily(VIXY)	快(4h)	美股
COMEX黄金	akshare futures_foreign_hist(GC)	快(4h)	美股
WTI原油	akshare futures_foreign_hist(CL)	快(4h)	美股
CNN恐惧贪婪指数	CNN dataviz API	快(4h)	美股
市值趋势(30天)	akshare stock_us_valuation_baidu	24h	美股

us_market_env_service.py — 大盘环境

数据	API/来源	缓存	市场
四大指数(道琼斯/纳斯达克/纳斯达克100/标普500)	akshare stock_us_daily	1h	美股
PE历史分位	akshare stock_us_valuation_baidu + stock_financial_us_analysis_indicator_em	24h	美股

bollinger_service.py — 布林带分析

数据	API/来源	缓存	市场
7周期布林带(1h/2h/4h/日/周/月/年)	akshare stock_us_daily + xueqiu 60m kline	4h(SQLite持久化)	美股

industry_service.py — 行业分析 (finvizfinance)

数据	API/来源	缓存	市场
板块/行业归属	finviz ticker_fundament	4h(SQLite持久化)	美股
个股表现(周/月/季/YTD/年)	finviz ticker_fundament	4h	美股
板块整体表现	finviz GroupOverview (按板块缓存)	4h	美股
同行业公司(Top5)	finviz screener	4h	美股
做空数据(Float/Ratio/Interest)	finviz ticker_fundament	4h	美股
机构/内部人持仓	finviz ticker_fundament	4h	美股
EPS预期(TTM/next Q/Y/5Y)	finviz ticker_fundament	4h	美股
营收(总额/Q-Q/Y-Y)	finviz ticker_fundament	4h	美股
估值(PE/PB/PS/PEG/EV-EBITDA/P-FCF)	finviz ticker_fundament	4h	美股
盈利能力(ROA/ROE/ROIC)	finviz ticker_fundament	4h	美股
分红(TTM/预期/除息日/增长)	finviz ticker_fundament	4h	美股
财务健康(利润率/负债率/流动比率)	finviz ticker_fundament	4h	美股
风险(Beta/ATR/波动率/52周范围)	finviz ticker_fundament	4h	美股
公司概况(描述/员工/IPO/指数成分)	finviz ticker_description + ticker_fundament	4h	美股
同行公司列表	finviz ticker_peer	4h	美股
ETF持仓	finviz ticker_etf_holders	4h	美股
内部交易(近5条)	finviz ticker_inside_trader	4h	美股
分析师评级变动(近5条)	finviz ticker_outer_ratings	4h	美股
英文新闻(近5条)	finviz ticker_news	4h	美股

tech_indicators_service.py — 技术指标补充 (本地计算)

数据	计算方式	缓存	市场
斐波那契回撤(5级)	60日高低点计算	无(实时)	全市场
ATR(14)	True Range 14日均值	无	全市场
OBV能量潮	量价累积 + 5日MA	无	全市场
VWAP(20日)	量价加权均价	无	全市场
K线形态(6种)	十字星/锤子线/射击之星/吞没/晨星/暮星	无	全市场
Sharpe比率(20d/60d)	收益率/标准差*sqrt(252)	无	全市场
年化波动率(20d/60d)	标准差*sqrt(252)	无	全市场
最大回撤(60d)	累积收益峰值回撤	无	全市场
相关性分析(vs SPY/QQQ)	akshare stock_us_daily + 收益率相关系数	无	美股
Beta/Alpha(60d)	协方差/方差 + 年化超额收益	无	美股

search_service.py — 新闻情报

数据	API/来源	缓存	市场
5维度中文新闻搜索	AkshareNews(东方财富)	无	全市场

表7: 元数据报告结构

章节	数据维度	来源
Dashboard	价格/PE/趋势/信号/RSI/Sharpe/回撤/目标价/财报日/恐惧贪婪	综合
行情概览	实时行情 + 今日/昨日OHLCV + MA状态 + 筹码分布	xueqiu/tencent/DB
技术分析	趋势/MACD/RSI/布林带(7周期)/斐波那契/ATR/OBV/VWAP/风险指标/K线形态/相关性	本地计算+akshare
基本面	成长/财报 + EPS预期/营收/估值/盈利能力/分红/财务健康	DB+finviz
行业与资金	板块/同行/做空/持仓/内部交易/分析师评级/ETF持仓	finviz
宏观环境	经济指标(7项)/美债/VIX/黄金/原油/CNN恐惧贪婪/大盘(4指数)/市值趋势/PE分位	akshare+CNN
公司概况	描述/指数成分/企业价值/员工/IPO/同行/ETF	finviz
新闻情报	英文新闻(finviz) + 中文新闻(AkshareNews)	finviz+akshare

---

生成时间：2026-03-20 扫描文件：efinance_fetcher.py, akshare_fetcher.py, tushare_fetcher.py, pytdx_fetcher.py, baostock_fetcher.py, xueqiu_fetcher.py, yfinance_fetcher.py, twelvedata_fetcher.py, tickflow_fetcher.py, base.py, fundamental_adapter.py, realtime_types.py, us_macro_service.py, us_market_env_service.py, bollinger_service.py, industry_service.py, tech_indicators_service.py, search_service.py