Yet another unofficial Yahoo Finance API library but with concurrent requests.

Index

1. Installation
2. Usage
   1. Demo
   2. Parameters
3. Troubleshooting
4. Contributing

Pyhoo requires Python >= 3.8

pip install pyhoo

Pyhoo is simple:

import pyhoo

tickers = ['FB', 'AAPL', 'AMZN', 'GOOGL']
start = '2020-02-01'
end = '2020-11-02'

stock_prices = pyhoo.get('chart', tickers, start=start, end=end, granularity="1d")
financial_reports = pyhoo.get('fundamentals', tickers, start=start, end=end)
options = pyhoo.get('options', tickers, strikeMax=400.0)

The result of pyhoo.get is a formatted pandas.DataFrame (here for stock prices):

Pyhoo is fast, it uses concurrency to fire multiple requests at the same time. You can request all the tickers of the S&P500 in one shot.

Pyhoo is still in development, feel free to add more endpoints thanks to the Config object !

Currently, it supports three endpoints:

1. chart, for OHLC data, basically stock prices
2. fundamentals, for financial data about the firm, see the list of available reports
3. options, for detailed information on each call and put at each strike on specific tickers

For each endpoint, you must specify a ticker or a list of tickers. Every ticker displayed in Yahoo Finance is valid.

The available parameters for the chart enpoint are :

• start [str] (required): date ('%Y-%m-%d') from which to get the stock prices
• end [str] (required): maximum date ('%Y-%m-%d') for the stock prices
• granularity [str] (optional, defaults to '1d'): data granularity, must be one of ['1m', '2m', '5m', '15m', '30m', '1h', '1d', '5d', '1w', '1mo', '3mo'] (ex: '1m' gives minute by minute data)

The available parameters for the fundamentals enpoint are :

• start [str] (required): date ('%Y-%m-%d') from which to get the reports
• end [str] (required): maximum date ('%Y-%m-%d') for the reports
• type [list[str]] (defaults to all types): name of the financial report to get, see the list of available reports for the full list. Each name must be prefixed with the specific frequency (annual, monthly, quarterly). Ex: to get annual diluted EPS and querterly gros profit -> [annualDilutedEPS, quarterlyGrossProfit].

The available parameters for the options enpoint are :

• start [str] (optional): date ('%Y-%m-%d') of the option emission
• end [str] (optional): date ('%Y-%m-%d') of the option expiration
• strikeMax [float] (optional): filter options with strike price above strikeMax
• strikeMin [float] (optional): filter options with strike price below strikeMin

By default, it retrieves every current option, regarding of its strike or expiration date.

If running from a Jupyter Notebook, you may encounter the following error:

RuntimeError: asyncio.run() cannot be called from a running event loop

This is because Jupyter Notebooks are running themselves in an event loop, and it is a known issue with asyncio.run.

There is a workaround, a bit hacky but gets the job done, using nest_asyncio.

pip install nest_asyncio

Then in the Notebook, before calling pyhoo.get:

import nest_asyncio
nest_asyncio.apply()

And you should be ok !

Contributions are welcome !

Pyhoo uses poetry as package manager. You can find the installation instructions here.

It is recommended to install the virtual environment in the project folder if you use VSCode, to help the linter resolve imports:

poetry config virtualenvs.path --unset
poetry config virtualenvs.in-project true

Once Poetry is configured, you can install required dependencies with:

poetry install

The CI enforces strict typing, linting and coverage.