yfinance

name	yfinance
description	查询全球股票行情、财务报表、分析师评级、期权链、选股筛选、K线下载等。 覆盖美股/港股/A股/全球市场。当用户问到股票价格、行情、K线、财务数据、 PE/市值/分红/持仓/期权/分析师评级/选股筛选等金融市场数据时触发。 数据来源 Yahoo Finance，仅限研究和教育用途。

yfinance CLI

通过 Yahoo Finance 公开 API 获取全球金融市场数据（基于 yahoo-finance2）

执行方式

bun ./tools/yf_cli.js <subcommand> [flags]

首次使用需安装依赖：

cd tools && bun install

代码格式

市场	格式	示例
美股	直接代码	AAPL, MSFT, GOOG
A股上交所	代码.SS	600519.SS（茅台）, 601318.SS（平安）
A股深交所	代码.SZ	000858.SZ（五粮液）, 000001.SZ（平安银行）
港股	代码.HK	0700.HK（腾讯）, 9988.HK（阿里）
日股	代码.T	7203.T（丰田）
英股	代码.L	SHEL.L（壳牌）
ETF	直接代码	SPY, QQQ, VOO
指数	^前缀	^GSPC（标普500）, ^DJI（道琼斯）, ^IXIC（纳斯达克）
加密货币	XXX-USD	BTC-USD, ETH-USD

子命令

quote - 实时报价

bun ./tools/yf_cli.js quote --symbols AAPL
bun ./tools/yf_cli.js quote --symbols "AAPL,MSFT,GOOG"
bun ./tools/yf_cli.js quote --symbols 600519.SS --json

多个代码用逗号分隔，一次批量请求。返回：当前价、涨跌额/幅、开高低收、成交量、市值、PE、52周高低

history - 历史K线

bun ./tools/yf_cli.js history --symbol AAPL --period 5d --interval 1d
bun ./tools/yf_cli.js history --symbol 600519.SS --period 1mo
bun ./tools/yf_cli.js history --symbol MSFT --period 1y --interval 1wk

period 可选: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max interval 可选: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo

info - 公司信息

bun ./tools/yf_cli.js info --symbol AAPL

返回：公司名称、行业、国家、员工数、市值、PE/PB/PS、分红率、ROE/ROA、利润率、负债率等

financials - 财务报表

bun ./tools/yf_cli.js financials --symbol AAPL --type income
bun ./tools/yf_cli.js financials --symbol MSFT --type balance --quarterly
bun ./tools/yf_cli.js financials --symbol GOOG --type cashflow --json

type: income（利润表）, balance（资产负债表）, cashflow（现金流量表） --quarterly 获取季报，默认年报。数据来自 fundamentals time-series，指标为行、报告期为列

holders - 持仓信息

bun ./tools/yf_cli.js holders --symbol AAPL

返回：内部人/机构持股比例、机构持仓Top10、内部人交易记录

dividends - 分红与拆股

bun ./tools/yf_cli.js dividends --symbol AAPL

返回：历史分红记录（最近20条）、股票拆分记录

options - 期权链

bun ./tools/yf_cli.js options --symbol AAPL
bun ./tools/yf_cli.js options --symbol AAPL --date 2026-06-20

返回：到期日列表、看涨/看跌期权的行权价、最新价、买卖价、成交量、持仓量、隐含波动率

analyst - 分析师评级

bun ./tools/yf_cli.js analyst --symbol AAPL

返回：综合评级、评级均分、分析师数量、目标价（高/低/均/中位）、评级趋势、升降级记录

news - 相关新闻

bun ./tools/yf_cli.js news --symbol AAPL --limit 5

compare - 多股对比

bun ./tools/yf_cli.js compare --symbols "AAPL,MSFT,GOOG"

返回对比表：价格、市值、PE、前瞻PE、PB、分红率、ROE、利润率、Beta、52周高低

search - 搜索

bun ./tools/yf_cli.js search --query "electric vehicle"
bun ./tools/yf_cli.js search --query bank

按关键词搜索标的与新闻。Yahoo 搜索端点对中文等非 ASCII 关键词返回 400， 查中概/A股/港股请直接用代码（如 0700.HK）或英文名

market - 市场概况

bun ./tools/yf_cli.js market --market us_market
bun ./tools/yf_cli.js market --market hk_market

通过各市场代表指数汇总行情。market 可选: us_market, gb_market, hk_market, cn_market, jp_market, de_market, fr_market, in_market

screen - 选股筛选（预设）

bun ./tools/yf_cli.js screen --preset day_gainers
bun ./tools/yf_cli.js screen --preset undervalued_large_caps --count 50
bun ./tools/yf_cli.js screen --preset most_actives --region US --json

使用 Yahoo 内置预设筛选器（不支持自定义条件组合）。--preset 取值： aggressive_small_caps, conservative_foreign_funds, day_gainers, day_losers, growth_technology_stocks, high_yield_bond, most_actives, most_shorted_stocks, portfolio_anchors, small_cap_gainers, solid_large_growth_funds, solid_midcap_growth_funds, top_mutual_funds, undervalued_growth_stocks, undervalued_large_caps 可选 --region（如 US/GB/DE）、--count（默认25）

download - 批量下载CSV

bun ./tools/yf_cli.js download --symbols "AAPL,MSFT" --period 1y --output stocks.csv

长表格式输出：Symbol,Date,Open,High,Low,Close,AdjClose,Volume

通用参数

• --json 所有子命令均支持，输出 JSON 格式
• 多个股票代码用逗号分隔

注意事项

• 运行时使用 bun（本机 node 版本可能低于 yahoo-finance2 v4 要求的 v22+）
• 依赖安装: cd tools && bun install（yahoo-finance2）
• 数据来源 Yahoo Finance 公开 API，非官方接口，偶尔可能不稳定
• A 股数据可能有 15 分钟延迟
• 分钟级 K 线（1m/2m/5m）最多回溯 7 天
• 期权数据仅美股可用
• 财务报表子模块自 2024-11 起改用 fundamentals time-series，部分历史期次字段可能缺失
• 选股仅支持 15 个预设筛选器，不支持自定义市值/PE/行业条件