Skip to main content

yf-data

application-build PyPI - Downloads

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

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

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.2.1.tar.gz (49.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yfdata-0.2.1-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file yfdata-0.2.1.tar.gz.

File metadata

  • Download URL: yfdata-0.2.1.tar.gz
  • Upload date:
  • Size: 49.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for yfdata-0.2.1.tar.gz
Algorithm Hash digest
SHA256 97f6bfbc8ff64eedcebe33734abc4d3adb300f87c49d905f8f1f7a3ee1e42619
MD5 cbedd8cea83d67f2a5f90d198dabc78c
BLAKE2b-256 09ddb2139e9940deb3316881cc9cea7807f61593bccdda779938aafabfee79f3

See more details on using hashes here.

File details

Details for the file yfdata-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: yfdata-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for yfdata-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8a30607dfc1c5939b87489d0fd12d8771aad8c4c3483afddb37ac51be42ec307
MD5 a5793a72e885fd745455db3c72bf3903
BLAKE2b-256 699f44790257dd6cf052caf0cc32bc3e3e66082057efed2ba2758045855b2d5a

See more details on using hashes here.

Supported by

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