自从雅虎金融部门停用了他们的历史数据API后，许多依赖它的程序都无法正常工作。yfinance 旨在通过提供一种可靠、线程化和Pythonic的方式从Yahoo金融下载历史市场数据来解决这个问题。

 快速开始Ticker 模块

该Ticker模块允许你以更Pythonic的方式访问股票数据：

注意：雅虎金融的日期时间接收为UTC。

importyfinanceasyfmsft=yf.Ticker("MSFT")#getstockinfomsft.info#gethistoricalmarketdatahist=msft.history(period="max")#showactions(dividends,splits)msft.actions#showdividendsmsft.dividends#showsplitsmsft.splits#showfinancialsmsft.financialsmsft.quarterly_financials#showmajorholdersmsft.major_holders#showinstitutionalholdersmsft.institutional_holders#showbalancesheetmsft.balance_sheetmsft.quarterly_balance_sheet#showcashflowmsft.cashflowmsft.quarterly_cashflow#showearningsmsft.earningsmsft.quarterly_earnings#showsustainabilitymsft.sustainability#showanalystsrecommendationsmsft.recommendations#shownextevent(earnings,etc)msft.calendar#showISINcode-*experimental*#ISIN=InternationalSecuritiesIdentificationNumbermsft.isin#showoptionsexpirationsmsft.options#shownewsmsft.news#getoptionchainforspecificexpirationopt=msft.option_chain('YYYY-MM-DD')#dataavailablevia:opt.calls,opt.puts如果要使用代理服务器下载数据，请使用：

importyfinanceasyfmsft=yf.Ticker("MSFT")msft.history(...,proxy="PROXY_SERVER")msft.get_actions(proxy="PROXY_SERVER")msft.get_dividends(proxy="PROXY_SERVER")msft.get_splits(proxy="PROXY_SERVER")msft.get_balance_sheet(proxy="PROXY_SERVER")msft.get_cashflow(proxy="PROXY_SERVER")msft.option_chain(...,proxy="PROXY_SERVER")...要使用自定义requests会话（例如缓存对API的调用或自定义User-agent标头），请将session=参数传递给Ticker构造函数。

importrequests_cachesession=requests_cache.CachedSession('yfinance.cache')session.headers['User-agent']='my-program/1.0'ticker=yf.Ticker('msftaaplgoog',session=session)#Thescrapedresponsewillbestoredinthecacheticker.actions要初始化多个Ticker对象，请使用

importyfinanceasyftickers=yf.Tickers('msftaaplgoog')#^returnsanamedtupleofTickerobjects#accesseachtickerusing(example)tickers.tickers.MSFT.infotickers.tickers.AAPL.history(period="1mo")tickers.tickers.GOOG.actions获取多个代码的数据importyfinanceasyfdata=yf.download("SPYAAPL",start="2017-01-01",end="2017-04-30")安装使用pip安装yfinance

$pipinstallyfinance--upgrade--no-cache-dir要求Python >=2.7,3.4+Pandas（经测试可与>=0.23.1一起使用）Numpy >=1.11.1requests >=2.14.2lxml >=4.5.1可选（如果你想使用pandas_datareader）pandas_datareader >=0.4.0