Skip to content

s-kerin/finance_calendars

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 to the right.

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)

About

Simple wrapper of NASDAQ public API for Financial Calendars, provides data on earnings calendar, IPO calendar, dividends calendar etc for ALL US stocks.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages