Yahoo Financials API
Lightweight SDK for interacting with the Yahoo Financials API. This is more geared on towards the three main financial records:
- balance sheet
- income statement
- cash flow
How to install?
pip3 install yahoo-fin-api
Examples
1. Get the data from the Yahoo Financials API
from yahoo_api import Client
def main():
client = Client(
cache_response= True, # Should cache the response after fetching from API
input_csv_file="./examples/freetrade_universe.csv", # Load the universe from this file
download_folder_path="./data") # Cache the data from the API in this folder
client.get_symbols()
if __name__ == "__main__":
main()
2. Load the balance sheet models
from yahoo_api import YahooFinApi, Client
from pprint import pprint
def main():
yf = YahooFinApi(
Client(
cache_response= True,
input_csv_file="./examples/freetrade_universe.csv",
download_folder_path="./data"
)
)
bs = yf.get_balance_sheets(["AAPL", "TSLA"])
pprint(bs)
if __name__ == "__main__":
main()
3. Load the cash flow models
from yahoo_api import YahooFinApi, Client
from pprint import pprint
def main():
yf = YahooFinApi(
Client(
cache_response= True,
input_csv_file="./examples/freetrade_universe.csv",
download_folder_path="./data"
)
)
cf = yf.get_cashflow_statements(["AAPL", "TSLA"])
pprint(cf)
if __name__ == "__main__":
main()
4. Load the income statement model
from yahoo_api import YahooFinApi, Client
from pprint import pprint
def main():
yf = YahooFinApi(
Client(
cache_response= True,
input_csv_file="./examples/freetrade_universe.csv",
download_folder_path="./data"
)
)
i_stmts = yf.get_income_statements(["AAPL", "TSLA"])
pprint(i_stmts)
if __name__ == "__main__":
main()
5. Load financial data model
from yahoo_api import YahooFinApi, Client
from pprint import pprint
def main():
yf = YahooFinApi(
Client(
cache_response= True,
input_csv_file="./examples/freetrade_universe.csv",
download_folder_path="./data"
)
)
cf = yf.get_financial_data(["AAPL", "TSLA"])
pprint(cf)
if __name__ == "__main__":
main()
6. Load summary detail model
from yahoo_api import YahooFinApi, Client
from pprint import pprint
def main():
yf = YahooFinApi(
Client(
cache_response= True,
input_csv_file="./examples/freetrade_universe.csv",
download_folder_path="./data"
)
)
sd = yf.get_summary_detail(["AAPL", "TSLA"])
pprint(sd)
if __name__ == "__main__":
main()
7. Get historic quotes
from yahoo_fin_api import YahooFinApi, Client, FileCache
from pprint import pprint
def main():
yf = YahooFinApi(Client(quote_cache=FileCache("./data/quotes", "quote")))
quotes = yf.get_quote("AAPL", "max")
pprint(quotes)
if __name__ == "__main__":
main()
Example of stock valuation based on 10 cap
from yahoo_api import YahooFinApi, Client
from yahoo_api.universe import symbols as get_symbols
from pprint import pprint
BILLION = 1000000000
def main():
yf = YahooFinApi(
Client(
cache_response= True,
download_folder_path="./data"
)
)
symbols = [
s.symbol for s in get_symbols("./examples/freetrade_universe.csv")
if s.isa_eligible == True and s.plus_only == False
]
tickers = yf.get_all(symbols)
res = []
for t in tickers:
fin_data = t.financial_data
summary = t.summary_detail
if fin_data is None or summary is None:
continue
if fin_data.free_cash_flow is None or summary.market_cap is None:
continue
if fin_data.free_cash_flow < 0:
continue
if summary.market_cap < 5 * BILLION:
continue
cap_rate = fin_data.free_cash_flow / summary.market_cap * 100
if cap_rate > 10:
res.append({
"symbol": t.symbol,
"cap_rate": cap_rate,
"market_cap": summary.market_cap,
"fcf": fin_data.free_cash_flow,
"current_price": fin_data.current_price
})
res = sorted(res, key=lambda r: r["cap_rate"], reverse=True)
pprint(res)
if __name__ == "__main__":
main()
Build your own cache system
To implement your own cache system, just create a class that implements this interface and pass it to the client.
You can use your custom cache as either symbol_cache or quote_cache, by passing it as param to the init method of the Client
class BaseCache:
def is_cached(self, symbol: str)-> bool:
raise Exception("method 'is_cached' not implemented")
def from_cache(self, symbol: str)-> dict:
raise Exception("method 'from_cache' not implemented")
def to_cache(self, symbol: str, body: dict)-> None:
raise Exception("method 'to_cache' not implemented")
def clear_cache(self, symbol: str)-> bool:
raise Exception("method 'clear_cache' not implemented")
Have a look at the FileCache (/yahoo_fin_api/cache/file_cache.py) as an example.
Metadata
Release files for yahoo-fin-api 0.0.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| yahoo_fin_api-0.0.21-py3-none-any.whl | Python 3 | none | any | Details for yahoo_fin_api-0.0.21-py3-none-any.whl |
Release files / yahoo_fin_api-0.0.21-py3-none-any.whl
| Download URL | yahoo_fin_api-0.0.21-py3-none-any.whl |
|---|---|
| Size | 22.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a324842afbec1266516847f2a470dd72f81a17662cf23df7a33ed8073d795e5a
|
|
BLAKE2b-256 checksum How to use checksums |
bc41d6ae07b1b45e6e23cc0741f177ac3a7f46a3480e8fd31c58e725cba555e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.0 CPython/3.9.12
|
Security for yahoo-fin-api 0.0.21
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.