# finance_calendars
Simple wrapper of NASDAQ public API for Financial Calendars. This returns calendar data on *ALL* US stocks.
Has this project saved you time and/or money? Consider buying me a coffee with the sponser link on the Github homepage.
## Features
* Earnings Calendar
* IPO Calendar
* Dividends Calendar
* Dividends History per symbol
* Splits History
### Install
Use the following pip command:
```
pip install finance-calendars
```
## Methods & Classes
```
get_earnings_today()
```
Returns all US earnings reports due on today's date.
```
get_earnings_by_date(date:datetime = None)
```
Returns all US earnings reports due on the specified date.
```
get_priced_ipos_this_month()
```
Returns all US IPOs *priced* for the current month. IPO data is reported by NASDAQ on a per month basis.
```
get_priced_ipos_by_month(date:datetime = None)
```
Returns all US IPOs *priced* for the specifed month. IPO data is reported by NASDAQ on a per month basis.
```
get_filed_ipos_this_month()
```
Returns all US IPOs *filed* for the current month. IPO data is reported by NASDAQ on a per month basis.
```
get_filed_ipos_by_month(date:datetime = None)
```
Returns all US IPOs *filed* for the specifed month. IPO data is reported by NASDAQ on a per month basis.
```
get_upcoming_ipos_this_month()
```
Returns all *upcoming* US IPOs for the current month. IPO data is reported by NASDAQ on a per month basis.
```
get_upcoming_ipos_by_month(date:datetime = None)
```
Returns all *upcoming* US IPOs for the specifed month. IPO data is reported by NASDAQ on a per month basis.
```
get_withdrawn_ipos_this_month()
```
Returns all *withdrawn* US IPOs for the current month. IPO data is reported by NASDAQ on a per month basis.
```
get_withdrawn_ipos_by_month(date:datetime = None)
```
Returns all *withdrawn* US IPOs for the specifed month. IPO data is reported by NASDAQ on a per month basis.
```
get_dividends_today()
```
Returns all US stocks with an ex-dividends date today.
```
get_splits_by_date(date:datetime = None)
```
Returns all US stock with an ex-dividends date on the specified date.
```
get_splits_today()
```
Returns all US stock splits due on today's date.
```
get_splits_by_date(date:datetime = None)
```
Returns all US stock splits on the specified date.
```
get_div_hist_per_stock(symbol:str)
```
Returns all dividend history for the given stock.
```
get_div_hist_per_etf(symbol:str)
```
Returns all dividend history for the given ETF.
## Examples
```
from finance_calendars import finance_calendars as fc
from datetime import datetime, date
import pandas as pd
earnings =fc.get_earnings_today()
print(earnings[:5])
earnings = fc.get_earnings_by_date(datetime(2021, 8, 16, 0, 0))
print(earnings[:5])
dividends = fc.get_dividends_today()
print(dividends[:5])
dividends = fc.get_dividends_by_date(datetime(2021, 8, 16, 0, 0))
print(dividends[:5])
ipos = fc.get_priced_ipos_this_month()
print(ipos[:5])
ipos = fc.get_priced_ipos_by_month(datetime(2021, 7, 1, 0, 0))
print(ipos[:5])
ipos = fc.get_filed_ipos_this_month()
print(ipos[:5])
ipos = fc.get_filed_ipos_by_month(datetime(2021, 7, 1, 0, 0))
print(ipos[:5])
ipos = fc.get_withdrawn_ipos_this_month()
print(ipos[:5])
ipos = fc.get_withdrawn_ipos_by_month(datetime(2021, 7, 1, 0, 0))
print(ipos[:5])
ipos = fc.get_upcoming_ipos_this_month()
print(ipos[:5])
ipos = fc.get_upcoming_ipos_by_month(datetime(2021, 7, 1, 0, 0))
print(ipos[:5])
splits = fc.get_splits_today()
print(splits[:5])
splits = fc.get_splits_by_date(datetime(2021, 8, 16, 0, 0))
print(splits[:5])
div_hist = fc.get_div_hist_per_stock('AAPL')
print(div_hist)
div_hist = fc.get_div_hist_per_etf('VIG')
print(div_hist)
```