A Python package that wraps YH Finance API endpoints and returns financial data in JSON. The API queries markets, stocks, news and conversations on Yahoo! Finance in real time to streamline the development of financial applications.
| #### IMPORTANT LEGAL DISCLAIMER --- yh-finance is **not** affiliated, endorsed, or vetted by Yahoo, Inc. It is an open-source tool that uses a publicly available API and is intended for research and educational purposes. |
pip install yh_financeimport yh_finance as yhfGet auto complete suggestions by term or phrase.
json_resp = yhf.auto_complete(query='tesla',
region='US',
api_key='YOUR_API_KEY')Get live price quotes.
json_resp = yhf.get_quotes(region='US',
symbols='AMD,IBM,AAPL',
api_key='YOUR_API_KEY')The live day gainers, losers, and actives in a specific region.
json_resp = yhf.get_movers(region='US',
lang='en-US',
count=5,
api_key='YOUR_API_KEY')Get live summary information of market by region.
json_resp = yhf.get_summary(region='US',
api_key='YOUR_API_KEY')Used with get_trending_tickers endpoint together to draw brief chart.
json_resp = yhf.get_spark(symbols='AMZN,AAPL,WDC,REYN,AZN',
interval='1m',
time_range='1d',
api_key='YOUR_API_KEY')Get recent earnings in the market.
json_resp = yhf.get_earnings(region='US',
start_date='1585155600000',
end_date='1589475600000',
size=10,
api_key='YOUR_API_KEY')Get latest trending tickers in the market (Count 20).
json_resp = yhf.get_trending_tickers(region='US',
api_key='YOUR_API_KEY')Get popular watchlists in the market.
json_resp = yhf.get_popular_watchlists(api_key='YOUR_API_KEY')Get performance information of specific watchlist.
json_resp = yhf.get_watchlist_performance(user_id='X3NJ2A7VDSABUI4URBWME2PZNM',
portfolio_id='the_berkshire_hathaway_portfolio',
symbols='^GSPC',
region='US',
api_key='YOUR_API_KEY')Get detail information of specific watchlist.
json_resp = yhf.get_watchlist_detail(user_id='X3NJ2A7VDSABUI4URBWME2PZNM',
portfolio_id='the_berkshire_hathaway_portfolio',
api_key='YOUR_API_KEY')Get data in summary section.
json_resp = yhf.get_summary(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get symbols similar to the specified one.
json_resp = yhf.get_recommendations(symbol='INTC',
api_key='YOUR_API_KEY')Get upgrade and downgrade data.
json_resp = yhf.get_upgrades_downgrades(symbol='INTC',
region='US',
api_key='YOUR_API_KEY')Get data to draw full screen chart.
json_resp = yhf.get_chart(interval='1mo',
symbol='AMRN',
time_range='1y',
region='US',
include_pre_post='false',
use_yahoo_id='true',
include_adj_close='true',
events='capitalGain,div,split',
api_key='YOUR_API_KEY')Get data in statistics section.
json_resp = yhf.get_statistics(symbol='JD',
api_key='YOUR_API_KEY')Get data in historical section.
json_resp = yhf.get_historical_data(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get data in profile section.
json_resp = yhf.get_profile(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get income statement and annual data in financial section.
json_resp = yhf.get_financials(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get quarterly data in financial section.
json_resp = yhf.get_timeseries(symbol='AMRN',
start_date='493578000',
end_date='1625011200',
region='US',
api_key='YOUR_API_KEY')Get cash flow data in financial section.
json_resp = yhf.get_cash_flow(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get balance sheet data in financial section.
json_resp = yhf.get_balance_sheet(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get data in analysis section.
json_resp = yhf.get_analysis(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get data in options section.
json_resp = yhf.get_options(symbol='AMRN',
date='1562284800',
region='US',
api_key='YOUR_API_KEY')Get major holders in holders section.
json_resp = yhf.get_holders(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get data in holdings section. The symbol must be a mutual fund stock.
json_resp = yhf.get_holdings(symbol='AMRN',
api_key='YOUR_API_KEY')Get brief reports relating to the symbol.
json_resp = yhf.get_insights(symbol='AAPL',
api_key='YOUR_API_KEY')Get insider transaction data in the holders section.
json_resp = yhf.get_insider_transactions(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get insider roster data in the holders section.
json_resp = yhf.get_insider_roster(symbol='AMRN',
region='US',
api_key='YOUR_API_KEY')Get conversations list relating to a symbol.
json_resp = yhf.get_conversation_list(symbol='AAPL',
message_board_id='finmb_24937',
region='US',
user_activity='true',
sort_by='createdAt',
off='0',
api_key='YOUR_API_KEY')