yfinance

Wraps the Yahoo Finance API to pull price history, financials, ratios, options, and more.
Author

Benedict Thekkel

Install

uv add yfinance

# !uv add yfinance

import yfinance as yf
print(yf.__version__)
1.2.0

Ticker Object

import yfinance as yf

ticker = yf.Ticker("AAPL")

ticker = yf.Ticker("AAPL")
ticker
yfinance.Ticker object <AAPL>

Price & History

# Historical OHLCV
hist = ticker.history(period="1y")        # 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
hist = ticker.history(start="2023-01-01", end="2024-01-01")
# Returns DataFrame: Open, High, Low, Close, Volume, Dividends, Stock Splits

# Fast price info
ticker.fast_info.last_price
ticker.fast_info.market_cap
ticker.fast_info.year_high
ticker.fast_info.year_low

hist = ticker.history(period="1mo")
hist.head()
Open High Low Close Volume Dividends Stock Splits
Date
2026-04-28 00:00:00-04:00 272.089320 272.978515 268.412715 270.460815 40018900 0.0 0.0
2026-04-29 00:00:00-04:00 267.303712 270.790520 266.794202 269.921326 30047900 0.0 0.0
2026-04-30 00:00:00-04:00 270.251027 275.745964 267.893213 271.100250 91848200 0.0 0.0
2026-05-01 00:00:00-04:00 278.603290 286.955610 278.113751 279.882141 79915400 0.0 0.0
2026-05-04 00:00:00-04:00 279.402577 280.371685 274.606977 276.575165 46668400 0.0 0.0
# Fast price info
print("Last price:         ", ticker.fast_info.last_price)
print("Market cap:         ", ticker.fast_info.market_cap)
print("52-week high:       ", ticker.fast_info.year_high)
print("52-week low:        ", ticker.fast_info.year_low)
Last price:          310.8500061035156
Market cap:          4565564702244.507
52-week high:        313.260009765625
52-week low:         195.07000732421875

Company Info

info = ticker.info
# Returns a large dict -- key fields:

info["longName"]              # Apple Inc.
info["sector"]                # Technology
info["industry"]              # Consumer Electronics
info["country"]               # United States
info["fullTimeEmployees"]     # 164000
info["longBusinessSummary"]   # description
info["website"]               # https://www.apple.com
info["exchange"]              # NMS
info["currency"]              # USD
info["quoteType"]             # EQUITY

info = ticker.info
keys = ["longName", "sector", "industry", "country", "fullTimeEmployees",
        "website", "exchange", "currency", "quoteType"]
for k in keys:
    print(f"{k:<30} {info.get(k)}")

info
longName                       Apple Inc.
sector                         Technology
industry                       Consumer Electronics
country                        United States
fullTimeEmployees              166000
website                        https://www.apple.com
exchange                       NMS
currency                       USD
quoteType                      EQUITY
{'address1': 'One Apple Park Way',
 'city': 'Cupertino',
 'state': 'CA',
 'zip': '95014',
 'country': 'United States',
 'phone': '(408) 996-1010',
 'website': 'https://www.apple.com',
 'industry': 'Consumer Electronics',
 'industryKey': 'consumer-electronics',
 'industryDisp': 'Consumer Electronics',
 'sector': 'Technology',
 'sectorKey': 'technology',
 'sectorDisp': 'Technology',
 'longBusinessSummary': 'Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a line of multi-purpose tablets; and wearables, home, and accessories comprising AirPods, Apple Vision Pro, Apple TV, Apple Watch, Beats products, and HomePod, as well as Apple branded and third-party accessories. It also provides AppleCare support and cloud services; and operates various platforms, including the App Store that allow customers to discover and download applications and digital content, such as books, music, video, games, and podcasts, as well as advertising services include third-party licensing arrangements and its own advertising platforms. In addition, the company offers various subscription-based services, such as Apple Arcade, a game subscription service; Apple Fitness+, a personalized fitness service; Apple Music, which offers users a curated listening experience with on-demand radio stations; Apple News+, a subscription news and magazine service; Apple TV, which offers exclusive original content and live sports; Apple Card, a co-branded credit card; and Apple Pay, a cashless payment service, as well as licenses its intellectual property. The company serves consumers, and small and mid-sized businesses; and the education, enterprise, and government markets. It distributes third-party applications for its products through the App Store. The company also sells its products through its retail and online stores, and direct sales force; and third-party cellular network carriers and resellers. The company was formerly known as Apple Computer, Inc. and changed its name to Apple Inc. in January 2007. Apple Inc. was founded in 1976 and is headquartered in Cupertino, California.',
 'fullTimeEmployees': 166000,
 'companyOfficers': [{'maxAge': 1,
   'name': 'Mr. Timothy D. Cook',
   'age': 64,
   'title': 'CEO & Director',
   'yearBorn': 1961,
   'fiscalYear': 2025,
   'totalPay': 16759518,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Mr. Kevan  Parekh',
   'age': 53,
   'title': 'Senior VP & CFO',
   'yearBorn': 1972,
   'fiscalYear': 2025,
   'totalPay': 4034174,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Mr. Sabih  Khan',
   'age': 58,
   'title': 'Senior VP & Chief Operating Officer',
   'yearBorn': 1967,
   'fiscalYear': 2025,
   'totalPay': 5021905,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': "Ms. Deirdre  O'Brien",
   'age': 58,
   'title': 'Senior Vice President of Retail & People',
   'yearBorn': 1967,
   'fiscalYear': 2025,
   'totalPay': 5037867,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Ms. Katherine L. Adams',
   'age': 61,
   'title': 'Senior VP of Government Affairs & Secretary',
   'yearBorn': 1964,
   'fiscalYear': 2025,
   'totalPay': 5022482,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Mr. Ben  Borders',
   'age': 44,
   'title': 'Principal Accounting Officer',
   'yearBorn': 1981,
   'fiscalYear': 2025,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Suhasini  Chandramouli',
   'title': 'Director of Investor Relations',
   'fiscalYear': 2025,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Ms. Jennifer G. Newstead J.D.',
   'age': 55,
   'title': 'Senior VP & General Counsel',
   'yearBorn': 1970,
   'fiscalYear': 2025,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Ms. Kristin Huguet Quayle',
   'title': 'Vice President of Worldwide Communications',
   'fiscalYear': 2025,
   'exercisedValue': 0,
   'unexercisedValue': 0},
  {'maxAge': 1,
   'name': 'Mr. Greg  Joswiak',
   'title': 'Senior Vice President of Worldwide Marketing',
   'fiscalYear': 2025,
   'exercisedValue': 0,
   'unexercisedValue': 0}],
 'auditRisk': 2,
 'boardRisk': 1,
 'compensationRisk': 7,
 'shareHolderRightsRisk': 1,
 'overallRisk': 1,
 'governanceEpochDate': 1777593600,
 'compensationAsOfEpochDate': 1767139200,
 'irWebsite': 'http://investor.apple.com/',
 'executiveTeam': [],
 'maxAge': 86400,
 'priceHint': 2,
 'previousClose': 308.33,
 'open': 308.44,
 'dayLow': 308.3,
 'dayHigh': 313.26,
 'regularMarketPreviousClose': 308.33,
 'regularMarketOpen': 308.44,
 'regularMarketDayLow': 308.3,
 'regularMarketDayHigh': 313.26,
 'dividendRate': 1.08,
 'dividendYield': 0.35,
 'exDividendDate': 1778457600,
 'payoutRatio': 0.1259,
 'fiveYearAvgDividendYield': 0.51,
 'beta': 1.065,
 'trailingPE': 37.587666,
 'forwardPE': 32.35352,
 'volume': 50328044,
 'regularMarketVolume': 50328044,
 'averageVolume': 43779844,
 'averageVolume10days': 44285220,
 'averageDailyVolume10Day': 44285220,
 'bid': 310.57,
 'ask': 311.16,
 'bidSize': 1,
 'askSize': 2,
 'marketCap': 4565564915712,
 'nonDilutedMarketCap': 4565564612600,
 'fiftyTwoWeekLow': 195.07,
 'fiftyTwoWeekHigh': 313.26,
 'allTimeHigh': 313.26,
 'allTimeLow': 0.049107,
 'priceToSalesTrailing12Months': 10.113292,
 'fiftyDayAverage': 272.8766,
 'twoHundredDayAverage': 262.39844,
 'trailingAnnualDividendRate': 1.04,
 'trailingAnnualDividendYield': 0.0033730094,
 'currency': 'USD',
 'tradeable': False,
 'enterpriseValue': 4581768560640,
 'profitMargins': 0.27152002,
 'floatShares': 14662387495,
 'sharesOutstanding': 14687356000,
 'sharesShort': 138782718,
 'sharesShortPriorMonth': 134422787,
 'sharesShortPreviousMonthDate': 1776211200,
 'dateShortInterest': 1778803200,
 'sharesPercentSharesOut': 0.0094,
 'heldPercentInsiders': 0.01633,
 'heldPercentInstitutions': 0.65801,
 'shortRatio': 2.84,
 'shortPercentOfFloat': 0.0095,
 'impliedSharesOutstanding': 14687356000,
 'bookValue': 7.26,
 'priceToBook': 42.816803,
 'lastFiscalYearEnd': 1758931200,
 'nextFiscalYearEnd': 1790467200,
 'mostRecentQuarter': 1774656000,
 'earningsQuarterlyGrowth': 0.194,
 'netIncomeToCommon': 122575003648,
 'trailingEps': 8.27,
 'forwardEps': 9.60792,
 'pegRatio': 2.68,
 'lastSplitFactor': '4:1',
 'lastSplitDate': 1598832000,
 'enterpriseToRevenue': 10.149,
 'enterpriseToEbitda': 28.64,
 '52WeekChange': 0.5546386,
 'SandP52WeekChange': 0.27201355,
 'lastDividendValue': 0.27,
 'lastDividendDate': 1778457600,
 'quoteType': 'EQUITY',
 'currentPrice': 310.85,
 'targetHighPrice': 400.0,
 'targetLowPrice': 215.0,
 'targetMeanPrice': 310.507,
 'targetMedianPrice': 310.0,
 'recommendationMean': 1.97917,
 'recommendationKey': 'buy',
 'numberOfAnalystOpinions': 43,
 'totalCash': 68507000832,
 'totalCashPerShare': 4.664,
 'ebitda': 159975997440,
 'totalDebt': 84710998016,
 'quickRatio': 0.906,
 'currentRatio': 1.07,
 'totalRevenue': 451442016256,
 'debtToEquity': 79.548,
 'revenuePerShare': 30.534,
 'returnOnAssets': 0.26229,
 'returnOnEquity': 1.4147099,
 'grossProfits': 216070995968,
 'freeCashflow': 101090746368,
 'operatingCashflow': 140222005248,
 'earningsGrowth': 0.218,
 'revenueGrowth': 0.166,
 'grossMargins': 0.47862,
 'ebitdaMargins': 0.35437,
 'operatingMargins': 0.32275,
 'financialCurrency': 'USD',
 'symbol': 'AAPL',
 'language': 'en-US',
 'region': 'US',
 'typeDisp': 'Equity',
 'quoteSourceName': 'Nasdaq Real Time Price',
 'triggerable': True,
 'customPriceAlertConfidence': 'HIGH',
 'hasPrePostMarketData': True,
 'firstTradeDateMilliseconds': 345479400000,
 'postMarketChangePercent': -0.080424644,
 'postMarketPrice': 310.6,
 'postMarketChange': -0.25,
 'regularMarketChange': 2.52002,
 'regularMarketDayRange': '308.3 - 313.26',
 'fullExchangeName': 'NasdaqGS',
 'averageDailyVolume3Month': 43779844,
 'fiftyTwoWeekLowChange': 115.78,
 'fiftyTwoWeekLowChangePercent': 0.5935305,
 'fiftyTwoWeekRange': '195.07 - 313.26',
 'fiftyTwoWeekHighChange': -2.4100037,
 'fiftyTwoWeekHighChangePercent': -0.0076933014,
 'fiftyTwoWeekChangePercent': 55.463863,
 'dividendDate': 1778716800,
 'earningsTimestamp': 1777579200,
 'earningsTimestampStart': 1785441600,
 'earningsTimestampEnd': 1785441600,
 'earningsCallTimestampStart': 1777582800,
 'earningsCallTimestampEnd': 1777582800,
 'isEarningsDateEstimate': True,
 'epsTrailingTwelveMonths': 8.27,
 'epsForward': 9.60792,
 'epsCurrentYear': 8.74834,
 'priceEpsCurrentYear': 35.53246,
 'fiftyDayAverageChange': 37.97342,
 'fiftyDayAverageChangePercent': 0.13915968,
 'twoHundredDayAverageChange': 48.45157,
 'twoHundredDayAverageChangePercent': 0.18464884,
 'sourceInterval': 15,
 'exchangeDataDelayedBy': 0,
 'averageAnalystRating': '2.0 - Buy',
 'cryptoTradeable': False,
 'corporateActions': [],
 'postMarketTime': 1779926397,
 'regularMarketTime': 1779912000,
 'exchange': 'NMS',
 'messageBoardId': 'finmb_24937',
 'exchangeTimezoneName': 'America/New_York',
 'exchangeTimezoneShortName': 'EDT',
 'gmtOffSetMilliseconds': -14400000,
 'market': 'us_market',
 'esgPopulated': False,
 'regularMarketChangePercent': 0.817312,
 'regularMarketPrice': 310.85,
 'shortName': 'Apple Inc.',
 'longName': 'Apple Inc.',
 'marketState': 'PREPRE',
 'displayName': 'Apple',
 'trailingPegRatio': 2.7049}

Financials

# Income statement
ticker.income_stmt                  # annual
ticker.quarterly_income_stmt        # quarterly

# Balance sheet
ticker.balance_sheet
ticker.quarterly_balance_sheet

# Cash flow
ticker.cashflow
ticker.quarterly_cashflow

# Key fields available:
# Total Revenue, Net Income, EBITDA, Gross Profit,
# Total Assets, Total Debt, Total Equity,
# Free Cash Flow, Operating Cash Flow

ticker.income_stmt
2025-09-30 2024-09-30 2023-09-30 2022-09-30 2021-09-30
Tax Effect Of Unusual Items 0.000000e+00 0.000000e+00 0.000000e+00 0.000000e+00 NaN
Tax Rate For Calcs 1.560000e-01 2.410000e-01 1.470000e-01 1.620000e-01 NaN
Normalized EBITDA 1.447480e+11 1.346610e+11 1.258200e+11 1.305410e+11 NaN
Net Income From Continuing Operation Net Minority Interest 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Reconciled Depreciation 1.169800e+10 1.144500e+10 1.151900e+10 1.110400e+10 NaN
Reconciled Cost Of Revenue 2.209600e+11 2.103520e+11 2.141370e+11 2.235460e+11 NaN
EBITDA 1.447480e+11 1.346610e+11 1.258200e+11 1.305410e+11 NaN
EBIT 1.330500e+11 1.232160e+11 1.143010e+11 1.194370e+11 NaN
Net Interest Income NaN NaN -1.830000e+08 -1.060000e+08 1.980000e+08
Interest Expense NaN NaN 3.933000e+09 2.931000e+09 2.645000e+09
Interest Income NaN NaN 3.750000e+09 2.825000e+09 2.843000e+09
Normalized Income 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Net Income From Continuing And Discontinued Operation 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Total Expenses 2.831110e+11 2.678190e+11 2.689840e+11 2.748910e+11 NaN
Total Operating Income As Reported 1.330500e+11 1.232160e+11 1.143010e+11 1.194370e+11 NaN
Diluted Average Shares 1.500470e+10 1.540810e+10 1.581255e+10 1.632582e+10 NaN
Basic Average Shares 1.494850e+10 1.534378e+10 1.574423e+10 1.621596e+10 NaN
Diluted EPS 7.460000e+00 6.080000e+00 6.130000e+00 6.110000e+00 NaN
Basic EPS 7.490000e+00 6.110000e+00 6.160000e+00 6.150000e+00 NaN
Diluted NI Availto Com Stockholders 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Net Income Common Stockholders 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Net Income 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Net Income Including Noncontrolling Interests 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Net Income Continuous Operations 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN
Tax Provision 2.071900e+10 2.974900e+10 1.674100e+10 1.930000e+10 NaN
Pretax Income 1.327290e+11 1.234850e+11 1.137360e+11 1.191030e+11 NaN
Other Income Expense -3.210000e+08 2.690000e+08 -5.650000e+08 -3.340000e+08 NaN
Other Non Operating Income Expenses -3.210000e+08 2.690000e+08 -5.650000e+08 -3.340000e+08 NaN
Net Non Operating Interest Income Expense NaN NaN -1.830000e+08 -1.060000e+08 1.980000e+08
Interest Expense Non Operating NaN NaN 3.933000e+09 2.931000e+09 2.645000e+09
Interest Income Non Operating NaN NaN 3.750000e+09 2.825000e+09 2.843000e+09
Operating Income 1.330500e+11 1.232160e+11 1.143010e+11 1.194370e+11 NaN
Operating Expense 6.215100e+10 5.746700e+10 5.484700e+10 5.134500e+10 NaN
Research And Development 3.455000e+10 3.137000e+10 2.991500e+10 2.625100e+10 NaN
Selling General And Administration 2.760100e+10 2.609700e+10 2.493200e+10 2.509400e+10 NaN
Gross Profit 1.952010e+11 1.806830e+11 1.691480e+11 1.707820e+11 NaN
Cost Of Revenue 2.209600e+11 2.103520e+11 2.141370e+11 2.235460e+11 NaN
Total Revenue 4.161610e+11 3.910350e+11 3.832850e+11 3.943280e+11 NaN
Operating Revenue 4.161610e+11 3.910350e+11 3.832850e+11 3.943280e+11 NaN
ticker.balance_sheet
2025-09-30 2024-09-30 2023-09-30 2022-09-30 2021-09-30
Treasury Shares Number NaN NaN 0.000000e+00 NaN NaN
Ordinary Shares Number 1.477326e+10 1.511679e+10 1.555006e+10 1.594342e+10 NaN
Share Issued 1.477326e+10 1.511679e+10 1.555006e+10 1.594342e+10 NaN
Net Debt 6.272300e+10 7.668600e+10 8.112300e+10 9.642300e+10 NaN
Total Debt 9.865700e+10 1.066290e+11 1.110880e+11 1.324800e+11 NaN
... ... ... ... ... ...
Cash Cash Equivalents And Short Term Investments 5.469700e+10 6.517100e+10 6.155500e+10 4.830400e+10 NaN
Other Short Term Investments 1.876300e+10 3.522800e+10 3.159000e+10 2.465800e+10 NaN
Cash And Cash Equivalents 3.593400e+10 2.994300e+10 2.996500e+10 2.364600e+10 NaN
Cash Equivalents 7.667000e+09 2.744000e+09 1.606000e+09 5.100000e+09 NaN
Cash Financial 2.826700e+10 2.719900e+10 2.835900e+10 1.854600e+10 NaN

69 rows × 5 columns

ticker.cashflow
2025-09-30 2024-09-30 2023-09-30 2022-09-30 2021-09-30
Free Cash Flow 9.876700e+10 1.088070e+11 9.958400e+10 1.114430e+11 NaN
Repurchase Of Capital Stock -9.071100e+10 -9.494900e+10 -7.755000e+10 -8.940200e+10 NaN
Repayment Of Debt -1.093200e+10 -9.958000e+09 -1.115100e+10 -9.543000e+09 NaN
Issuance Of Debt 4.481000e+09 0.000000e+00 5.228000e+09 5.465000e+09 NaN
Issuance Of Capital Stock NaN NaN NaN NaN 1.105000e+09
Capital Expenditure -1.271500e+10 -9.447000e+09 -1.095900e+10 -1.070800e+10 NaN
Interest Paid Supplemental Data NaN NaN 3.803000e+09 2.865000e+09 2.687000e+09
Income Tax Paid Supplemental Data 4.336900e+10 2.610200e+10 1.867900e+10 1.957300e+10 NaN
End Cash Position 3.593400e+10 2.994300e+10 3.073700e+10 2.497700e+10 NaN
Beginning Cash Position 2.994300e+10 3.073700e+10 2.497700e+10 3.592900e+10 NaN
Changes In Cash 5.991000e+09 -7.940000e+08 5.760000e+09 -1.095200e+10 NaN
Financing Cash Flow -1.206860e+11 -1.219830e+11 -1.084880e+11 -1.107490e+11 NaN
Cash Flow From Continuing Financing Activities -1.206860e+11 -1.219830e+11 -1.084880e+11 -1.107490e+11 NaN
Net Other Financing Charges -6.071000e+09 -5.802000e+09 -6.012000e+09 -6.383000e+09 NaN
Cash Dividends Paid -1.542100e+10 -1.523400e+10 -1.502500e+10 -1.484100e+10 NaN
Common Stock Dividend Paid -1.542100e+10 -1.523400e+10 -1.502500e+10 -1.484100e+10 NaN
Net Common Stock Issuance -9.071100e+10 -9.494900e+10 -7.755000e+10 -8.940200e+10 NaN
Common Stock Payments -9.071100e+10 -9.494900e+10 -7.755000e+10 -8.940200e+10 NaN
Common Stock Issuance NaN NaN NaN NaN 1.105000e+09
Net Issuance Payments Of Debt -8.483000e+09 -5.998000e+09 -9.901000e+09 -1.230000e+08 NaN
Net Short Term Debt Issuance -2.032000e+09 3.960000e+09 -3.978000e+09 3.955000e+09 NaN
Net Long Term Debt Issuance -6.451000e+09 -9.958000e+09 -5.923000e+09 -4.078000e+09 NaN
Long Term Debt Payments -1.093200e+10 -9.958000e+09 -1.115100e+10 -9.543000e+09 NaN
Long Term Debt Issuance 4.481000e+09 0.000000e+00 5.228000e+09 5.465000e+09 NaN
Investing Cash Flow 1.519500e+10 2.935000e+09 3.705000e+09 -2.235400e+10 NaN
Cash Flow From Continuing Investing Activities 1.519500e+10 2.935000e+09 3.705000e+09 -2.235400e+10 NaN
Net Other Investing Changes -1.480000e+09 -1.308000e+09 -1.337000e+09 -2.086000e+09 NaN
Net Investment Purchase And Sale 2.939000e+10 1.369000e+10 1.600100e+10 -9.560000e+09 NaN
Sale Of Investment 5.379700e+10 6.234600e+10 4.551400e+10 6.736300e+10 NaN
Purchase Of Investment -2.440700e+10 -4.865600e+10 -2.951300e+10 -7.692300e+10 NaN
Net Business Purchase And Sale NaN NaN NaN -3.060000e+08 -3.300000e+07
Purchase Of Business NaN NaN NaN -3.060000e+08 -3.300000e+07
Net PPE Purchase And Sale -1.271500e+10 -9.447000e+09 -1.095900e+10 -1.070800e+10 NaN
Purchase Of PPE -1.271500e+10 -9.447000e+09 -1.095900e+10 -1.070800e+10 NaN
Operating Cash Flow 1.114820e+11 1.182540e+11 1.105430e+11 1.221510e+11 NaN
Cash Flow From Continuing Operating Activities 1.114820e+11 1.182540e+11 1.105430e+11 1.221510e+11 NaN
Change In Working Capital -2.500000e+10 3.651000e+09 -6.577000e+09 1.200000e+09 NaN
Change In Other Working Capital NaN NaN NaN 4.780000e+08 1.676000e+09
Change In Other Current Liabilities -1.107600e+10 1.555200e+10 3.031000e+09 6.110000e+09 NaN
Change In Other Current Assets -9.197000e+09 -1.173100e+10 -5.684000e+09 -6.499000e+09 NaN
Change In Payables And Accrued Expense 9.020000e+08 6.020000e+09 -1.889000e+09 9.448000e+09 NaN
Change In Payable 9.020000e+08 6.020000e+09 -1.889000e+09 9.448000e+09 NaN
Change In Account Payable 9.020000e+08 6.020000e+09 -1.889000e+09 9.448000e+09 NaN
Change In Inventory 1.400000e+09 -1.046000e+09 -1.618000e+09 1.484000e+09 NaN
Change In Receivables -7.029000e+09 -5.144000e+09 -4.170000e+08 -9.343000e+09 NaN
Changes In Account Receivables -6.682000e+09 -3.788000e+09 -1.688000e+09 -1.823000e+09 NaN
Other Non Cash Items -8.900000e+07 -2.266000e+09 -2.227000e+09 1.006000e+09 NaN
Stock Based Compensation 1.286300e+10 1.168800e+10 1.083300e+10 9.038000e+09 NaN
Deferred Tax NaN NaN NaN 8.950000e+08 -4.774000e+09
Deferred Income Tax NaN NaN NaN 8.950000e+08 -4.774000e+09
Depreciation Amortization Depletion 1.169800e+10 1.144500e+10 1.151900e+10 1.110400e+10 NaN
Depreciation And Amortization 1.169800e+10 1.144500e+10 1.151900e+10 1.110400e+10 NaN
Net Income From Continuing Operations 1.120100e+11 9.373600e+10 9.699500e+10 9.980300e+10 NaN

Valuation & Ratios

info["marketCap"]             # market capitalisation
info["enterpriseValue"]
info["trailingPE"]            # P/E ratio
info["forwardPE"]
info["priceToBook"]           # P/B ratio
info["priceToSalesTrailing12Months"]
info["pegRatio"]
info["trailingEps"]
info["forwardEps"]
info["bookValue"]
info["debtToEquity"]
info["returnOnEquity"]
info["returnOnAssets"]
info["revenueGrowth"]
info["earningsGrowth"]
info["grossMargins"]
info["operatingMargins"]
info["profitMargins"]
info["ebitda"]
info["totalDebt"]
info["totalCash"]
info["freeCashflow"]

ratio_keys = [
    "marketCap", "enterpriseValue", "trailingPE", "forwardPE",
    "priceToBook", "priceToSalesTrailing12Months", "pegRatio",
    "trailingEps", "forwardEps", "bookValue", "debtToEquity",
    "returnOnEquity", "returnOnAssets", "revenueGrowth", "earningsGrowth",
    "grossMargins", "operatingMargins", "profitMargins",
    "ebitda", "totalDebt", "totalCash", "freeCashflow",
]
for k in ratio_keys:
    print(f"{k:<40} {info.get(k)}")
marketCap                                4565564915712
enterpriseValue                          4581768560640
trailingPE                               37.587666
forwardPE                                32.35352
priceToBook                              42.816803
priceToSalesTrailing12Months             10.113292
pegRatio                                 2.68
trailingEps                              8.27
forwardEps                               9.60792
bookValue                                7.26
debtToEquity                             79.548
returnOnEquity                           1.4147099
returnOnAssets                           0.26229
revenueGrowth                            0.166
earningsGrowth                           0.218
grossMargins                             0.47862
operatingMargins                         0.32275
profitMargins                            0.27152002
ebitda                                   159975997440
totalDebt                                84710998016
totalCash                                68507000832
freeCashflow                             101090746368

Dividends & Splits

ticker.dividends          # historical dividend payments (Series)
ticker.splits             # historical stock splits (Series)
ticker.actions            # dividends + splits combined

info["dividendRate"]
info["dividendYield"]
info["exDividendDate"]
info["payoutRatio"]
info["fiveYearAvgDividendYield"]

ticker.dividends.tail()
Date
2025-05-12 00:00:00-04:00    0.26
2025-08-11 00:00:00-04:00    0.26
2025-11-10 00:00:00-05:00    0.26
2026-02-09 00:00:00-05:00    0.26
2026-05-11 00:00:00-04:00    0.27
Name: Dividends, dtype: float64
ticker.splits
Date
1987-06-16 00:00:00-04:00    2.0
2000-06-21 00:00:00-04:00    2.0
2005-02-28 00:00:00-05:00    2.0
2014-06-09 00:00:00-04:00    7.0
2020-08-31 00:00:00-04:00    4.0
Name: Stock Splits, dtype: float64
div_keys = ["dividendRate", "dividendYield", "exDividendDate", "payoutRatio", "fiveYearAvgDividendYield"]
for k in div_keys:
    print(f"{k:<35} {info.get(k)}")
dividendRate                        1.08
dividendYield                       0.35
exDividendDate                      1778457600
payoutRatio                         0.1259
fiveYearAvgDividendYield            0.51

Analyst Data

ticker.recommendations          # analyst buy/sell/hold history
ticker.recommendations_summary  # summary of current recommendations
ticker.upgrades_downgrades      # recent rating changes
ticker.analyst_price_targets    # current price targets

info["targetHighPrice"]
info["targetLowPrice"]
info["targetMeanPrice"]
info["targetMedianPrice"]
info["recommendationKey"]       # "buy", "hold", "sell"
info["numberOfAnalystOpinions"]

ticker.recommendations.tail()
period strongBuy buy hold sell strongSell
0 0m 7 23 15 1 2
1 -1m 7 25 14 1 1
2 -2m 6 25 15 1 1
3 -3m 5 25 16 1 1
ticker.recommendations_summary
period strongBuy buy hold sell strongSell
0 0m 7 23 15 1 2
1 -1m 7 25 14 1 1
2 -2m 6 25 15 1 1
3 -3m 5 25 16 1 1
ticker.analyst_price_targets
{'current': 310.85,
 'high': 400.0,
 'low': 215.0,
 'mean': 310.507,
 'median': 310.0}
analyst_keys = ["targetHighPrice", "targetLowPrice", "targetMeanPrice",
                "targetMedianPrice", "recommendationKey", "numberOfAnalystOpinions"]
for k in analyst_keys:
    print(f"{k:<35} {info.get(k)}")
targetHighPrice                     400.0
targetLowPrice                      215.0
targetMeanPrice                     310.507
targetMedianPrice                   310.0
recommendationKey                   buy
numberOfAnalystOpinions             43

Options

# Available expiry dates
ticker.options                  # tuple of date strings

# Options chain for a specific expiry
opt = ticker.option_chain("2024-06-21")
opt.calls                       # DataFrame of call options
opt.puts                        # DataFrame of put options

# Columns: strike, lastPrice, bid, ask, volume, openInterest,
#          impliedVolatility, inTheMoney

print("Expiry dates:", ticker.options[:5])
Expiry dates: ('2026-05-29', '2026-06-01', '2026-06-03', '2026-06-05', '2026-06-12')
expiry = ticker.options[0]
opt = ticker.option_chain(expiry)
opt.calls.head()
contractSymbol lastTradeDate strike lastPrice bid ask change percentChange volume openInterest impliedVolatility inTheMoney contractSize currency
0 AAPL260529C00110000 2026-05-26 19:04:44+00:00 110.0 199.42 0.0 0.0 0.0 0.0 3.0 0 0.00001 True REGULAR USD
1 AAPL260529C00120000 2026-05-12 14:29:11+00:00 120.0 173.96 0.0 0.0 0.0 0.0 1.0 0 0.00001 True REGULAR USD
2 AAPL260529C00185000 2026-05-26 19:25:22+00:00 185.0 123.42 0.0 0.0 0.0 0.0 1.0 0 0.00001 True REGULAR USD
3 AAPL260529C00190000 2026-05-27 14:15:41+00:00 190.0 122.70 0.0 0.0 0.0 0.0 4.0 0 0.00001 True REGULAR USD
4 AAPL260529C00195000 2026-05-26 17:06:12+00:00 195.0 115.23 0.0 0.0 0.0 0.0 264.0 0 0.00001 True REGULAR USD
opt.puts.head()
contractSymbol lastTradeDate strike lastPrice bid ask change percentChange volume openInterest impliedVolatility inTheMoney contractSize currency
0 AAPL260529P00110000 2026-05-26 15:58:05+00:00 110.0 0.01 0.0 0.0 0.0 0.0 1 0 0.500005 False REGULAR USD
1 AAPL260529P00130000 2026-05-15 15:43:38+00:00 130.0 0.18 0.0 0.0 0.0 0.0 1 0 0.500005 False REGULAR USD
2 AAPL260529P00135000 2026-04-17 14:36:16+00:00 135.0 0.14 0.0 0.0 0.0 0.0 2 0 0.500005 False REGULAR USD
3 AAPL260529P00155000 2026-05-27 15:50:55+00:00 155.0 0.16 0.0 0.0 0.0 0.0 1 0 0.500005 False REGULAR USD
4 AAPL260529P00160000 2026-05-27 18:24:11+00:00 160.0 0.12 0.0 0.0 0.0 0.0 3 0 0.500005 False REGULAR USD

Holders & Ownership

ticker.major_holders             # institutional/insider % breakdown
ticker.institutional_holders     # top institutional holders
ticker.mutualfund_holders        # top mutual fund holders
ticker.insider_transactions      # recent insider buys/sells
ticker.insider_purchases
ticker.insider_roster_holders

ticker.major_holders
Breakdown Value
insidersPercentHeld 0.01633
institutionsPercentHeld 0.65801
institutionsFloatPercentHeld 0.66893
institutionsCount 7649.00000
ticker.institutional_holders.head()
Date Reported Holder pctHeld Shares Value pctChange
0 2026-03-31 Blackrock Inc. 0.0779 1144695425 355828579847 -0.0086
1 2026-03-31 Vanguard Capital Management LLC 0.0649 953847648 296503547202 1.0000
2 2026-03-31 State Street Corporation 0.0410 602341409 187237830664 -0.0028
3 2026-03-31 Geode Capital Management, LLC 0.0251 368616954 114584582400 0.0296
4 2026-03-31 Vanguard Portfolio Management LLC 0.0226 331437055 103027210569 1.0000
ticker.mutualfund_holders.head()
Date Reported Holder pctHeld Shares Value pctChange
0 2025-12-31 VANGUARD INDEX FUNDS-Vanguard Total Stock Mark... 0.0316 464375258 144351051783 -0.0059
1 2025-12-31 VANGUARD INDEX FUNDS-Vanguard 500 Index Fund 0.0254 372615534 115827541018 0.0177
2 2026-04-30 iShares Trust-iShares Core S&P 500 ETF 0.0129 189894457 59028693117 0.0063
3 2026-03-31 Fidelity Concord Street Trust-Fidelity 500 Ind... 0.0128 187489423 58281088283 -0.0030
4 2026-04-30 SPDR S&P 500 ETF TRUST-State Street SPDR S&P 5... 0.0119 175431347 54532835285 0.0305

News & Events

ticker.news                      # list of recent news articles
# Each article: title, publisher, link, providerPublishTime, thumbnail

ticker.earnings_dates            # upcoming + past earnings dates
ticker.calendar                  # next earnings, ex-dividend date

import pandas as pd
news = ticker.news
pd.DataFrame([{"title": a["content"]["title"], "publisher": a["content"]["provider"]["displayName"]} for a in news[:5]])
title publisher
0 Why Android takes a bigger hit than Apple from... Yahoo Finance Video
1 Jensen Huang Joins Elite Tsinghua University A... Benzinga
2 Eli Lilly Stock Hits Record Highs, Becomes Fir... Zacks
3 Top Analyst Reports for Alphabet, Apple & Micr... Zacks
4 Buy, Sell, or Hold Vanguard’s Mega Cap Growth ... 24/7 Wall St.
ticker.earnings_dates.head()
EPS Estimate Reported EPS Surprise(%)
Earnings Date
2026-07-30 16:00:00-04:00 1.90 NaN NaN
2026-04-30 16:00:00-04:00 1.94 2.01 3.46
2026-01-29 16:00:00-05:00 2.67 2.84 6.34
2025-10-30 16:00:00-04:00 1.77 1.85 4.52
2025-07-31 16:00:00-04:00 1.43 1.57 10.12
ticker.calendar
{'Dividend Date': datetime.date(2026, 5, 14),
 'Ex-Dividend Date': datetime.date(2026, 5, 11),
 'Earnings Date': [datetime.date(2026, 7, 31)],
 'Earnings High': 1.99,
 'Earnings Low': 1.83,
 'Earnings Average': 1.89541,
 'Revenue High': 112168000000,
 'Revenue Low': 107501000000,
 'Revenue Average': 109015606590}

Multiple Tickers

# Download price history for multiple tickers at once
df = yf.download(["AAPL", "MSFT", "GOOGL"], period="1y")

# Or use Tickers object
tickers = yf.Tickers("AAPL MSFT GOOGL")
tickers.tickers["AAPL"].info
tickers.tickers["MSFT"].history(period="1mo")

df = yf.download(["AAPL", "MSFT", "GOOGL"], period="1mo", auto_adjust=True)
df["Close"].tail()
[*********************100%***********************]  3 of 3 completed
Ticker AAPL GOOGL MSFT
Date
2026-05-20 302.250000 388.910004 420.149994
2026-05-21 304.989990 387.660004 419.089996
2026-05-22 308.820007 382.970001 418.570007
2026-05-26 308.329987 388.880005 416.029999
2026-05-27 310.850006 388.829987 412.670013
multi = yf.Tickers("AAPL MSFT GOOGL")
multi.tickers["MSFT"].fast_info.last_price
412.6700134277344

Sector / Market Data

# Sector performance
sector = yf.Sector("technology")
sector.overview
sector.top_companies
sector.top_etfs

# Industry
industry = yf.Industry("consumer-electronics")
industry.overview
industry.top_companies

# Market indices
sp500 = yf.Ticker("^GSPC")
nasdaq = yf.Ticker("^IXIC")
asx200 = yf.Ticker("^AXJO")     # ASX 200

sector = yf.Sector("technology")
sector.overview
sector.top_companies.head()
asx200 = yf.Ticker("^AXJO")
asx200.history(period="5d")[["Open", "High", "Low", "Close", "Volume"]]

Caveats

  • Unofficial API – Yahoo can break it without notice, has done so before
  • Rate limits – don’t hammer it; add delays for bulk requests
  • Data quality – good for most use cases, not suitable for HFT or production trading systems
  • ticker.info – the most fragile endpoint, fields vary by ticker type and region
  • ASX stocks – append .AX to the ticker: yf.Ticker("CBA.AX")

Back to top