Calendars#

Get economic calendars, for example, Earnings, IPO, Economic Events, Splits

### Simple example default params: `python import yfinance as yf calendars = yf.Calendars() earnings_calendar = calendars.get_earnings_calendar(limit=50) print(earnings_calendar) `

Parameters:

start (str | datetime | date) – start date (default today) eg. start=”2025-11-08”
end (str | datetime | date) – end date (default start + 7 days) eg. end=”2025-11-08”
session – requests.Session object, optional

Attributes

earnings_calendar: Earnings calendar with default settings.

economic_events_calendar: Economic events calendar with default settings.

ipo_info_calendar: IPOs calendar with default settings.

splits_calendar: Splits calendar with default settings.

Methods

Parameters:

start (str | datetime | date) – start date (default today) eg. start=”2025-11-08”
end (str | datetime | date) – end date (default start + 7 days) eg. end=”2025-11-08”
session – requests.Session object, optional

get_earnings_calendar(market_cap: float | None = None, filter_most_active: bool = True, start=None, end=None, limit=12, offset=0, force=False) → DataFrame

Retrieve earnings calendar from YF as a DataFrame. Will re-query every time it is called, overwriting previous data.

Parameters:

market_cap – market cap cutoff in USD, default None
filter_most_active – will filter for actively traded stocks (default True)
start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with earnings calendar

get_economic_events_calendar(start=None, end=None, limit=12, offset=0, force=False) → DataFrame

Retrieve Economic Events calendar from YF as a DataFrame.

Parameters:

start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with Economic Events calendar

get_ipo_info_calendar(start=None, end=None, limit=12, offset=0, force=False) → DataFrame

Retrieve IPOs calendar from YF as a Dataframe.

Parameters:

start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with IPOs calendar

get_splits_calendar(start=None, end=None, limit=12, offset=0, force=False) → DataFrame

Retrieve Splits calendar from YF as a DataFrame.

Parameters:

start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with Splits calendar

get_earnings_calendar(market_cap: float | None = None, filter_most_active: bool = True, start=None, end=None, limit=12, offset=0, force=False) → DataFrame#

Retrieve earnings calendar from YF as a DataFrame. Will re-query every time it is called, overwriting previous data.

Parameters:

market_cap – market cap cutoff in USD, default None
filter_most_active – will filter for actively traded stocks (default True)
start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with earnings calendar

get_economic_events_calendar(start=None, end=None, limit=12, offset=0, force=False) → DataFrame#

Retrieve Economic Events calendar from YF as a DataFrame.

Parameters:

start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with Economic Events calendar

get_ipo_info_calendar(start=None, end=None, limit=12, offset=0, force=False) → DataFrame#

Retrieve IPOs calendar from YF as a Dataframe.

Parameters:

start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with IPOs calendar

get_splits_calendar(start=None, end=None, limit=12, offset=0, force=False) → DataFrame#

Retrieve Splits calendar from YF as a DataFrame.

Parameters:

start (str | datetime | date) – overwrite start date (default set by __init__) eg. start=”2025-11-08”
end (str | datetime | date) – overwrite end date (default set by __init__) eg. end=”2025-11-08”
limit – maximum number of results to return (YF caps at 100)
offset – offsets the results for pagination. YF default 0
force – if True, will re-query even if cache already exists

Returns:

DataFrame with Splits calendar