Skip to main content

Client for Yahoo Finance data

Project description

yf-data

application-build GitHub Downloads PyPI - Downloads

A simple-but-working python module that returns data from Yahoo Finance.

Current Version: 0.1.1

Features

Data include OHLC values for:

  • stocks and exchange rates
  • dividends
  • financial data of companies (income and balance sheets).

All data are returned as Pandas Dataframe.

Usage

from yfdata import YahooProvider

yp = YahooProvider()

# Frequency for prices and exchange rates can be daily ("1D") or 1-minute ("1m").
 
# Get daily OHLC data.
df = yp.get_prices(["aapl"], "1D")

# Get exchange rates with frequency of 1 minute.
df = yp.get_rates("usd", "eur", freq="1m")

# Get company dividends.
df = yp.get_dividends(["aapl", "msft"])


# Frequency for income data can be annual ("A"), quarterly ("Q") or 
# trailing twelwe months ("TTM").

# Frequency for balance data can be annual ("A") or quarterly ("Q"). 

# Get annual income data.
df = yp.get_income(["aapl", "msft"], freq="A")

# Get quarterly balance data.
df = yp.get_balance(["aapl", "msft"], freq="Q")

# Define a list of specific metrics for income data.
metrics = ["total_revenue", "ebitda"]
df = yp.get_income(["aapl", "msft"], freq="A", metrics=metrics)

Output examples

An excerpt from 1-minute OHLC price data:

ticker ts o h l c v
aapl 2024-07-26 13:30:00 218.850006 219.149902 218.089996 218.740005 1170434.0
aapl 2024-07-26 13:31:00 218.389999 218.470001 218.000000 218.020004 382342.0
aapl 2024-07-26 13:32:00 218.054993 218.740005 218.020004 218.481903 227239.0
aapl 2024-07-26 13:33:00 218.479996 218.539993 217.669998 217.669998 263403.0
aapl 2024-07-26 13:34:00 217.630005 217.630005 217.119995 217.160004 241679.0

An excerpt from annual balance data:

ticker metric freq date value
aapl total_assets A 2020-09-30 3.23888e+11
aapl total_assets A 2021-09-30 3.51002e+11
aapl total_assets A 2022-09-30 3.52755e+11
aapl total_assets A 2023-09-30 3.52583e+11
aapl ordinary_shares_number A 2020-09-30 1.69768e+10
aapl ordinary_shares_number A 2021-09-30 1.64268e+10
aapl ordinary_shares_number A 2022-09-30 1.59434e+10
aapl ordinary_shares_number A 2023-09-30 1.55501e+10

Financial metrics

Available metrics for income sheet are:

  • total_revenue
  • cost_of_revenue
  • gross_profit
  • operating_expense
  • operating_income
  • non_operating_interest_income_expense
  • other_income_expense
  • basic_eps
  • diluted_eps
  • basic_average_shares
  • total_expense
  • normalized_income
  • ebit
  • ebitda

Available metrics for balance sheet are:

  • total_assets
  • total_liabilities_net_minority_interest
  • total_equity_gross_minority_interest
  • total_capitalization
  • common_stock_equity
  • capital_lease_obligations
  • net_tangible_assets
  • working_capital
  • invested_capital
  • tangible_book_value
  • total_debt
  • net_debt
  • share_issued
  • ordinary_shares_number

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yfdata-0.1.1.tar.gz (8.3 kB view hashes)

Uploaded Source

Built Distribution

yfdata-0.1.1-py3-none-any.whl (9.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page