Core Reference

The Ticker Class

Most of the unofficial Yahoo Finance API is company-centric, so yahooquery models it as a single class. One Ticker instance gives you access to 60+ data modules as properties and methods.

pythonticker.py
from yahooquery import Ticker

aapl = Ticker('aapl')

Popular properties

PropertyReturnsContents
summary_detaildictPrice, volume, market cap, day range, dividend yield
pricedictCurrent price, currency, exchange, market state
financial_datadictMargins, revenue, cash position, debt
key_statsdictValuation ratios, share counts, short interest
asset_profiledictCompany description, officers, sector, website
quote_typedictInstrument type, exchange, timezone
calendar_eventsdictUpcoming earnings and dividend dates

Popular methods

MethodWhat it does
history()OHLCV prices over any period and interval — see Historical Data
income_statement()Quarterly or annual income statements — see Financials
balance_sheet()Balance sheet line items
cash_flow()Cash flow statements
news()Recent news stories for the symbol
option_chain()Full options chain with greeks
earnings_history()Past earnings dates, estimates vs. actuals

Fetching specific modules

If you know exactly which Yahoo modules you want, request them directly:

pythonmodules.py
aapl.get_modules(['summaryDetail', 'financialData', 'defaultKeyStatistics'])
Tip: every property above also works on a multi-symbol Ticker. See Multiple Symbols.