Struct MarketCalendar 

pub struct MarketCalendar { /* private fields */ }

Market-wide event calendars backed by configured data providers.

Routes through Capability::CALENDAR. Unlike Ticker::calendar, which builds a per-symbol timeline, these span the whole market over a date range.

Created via Providers::calendar.

Implementations

impl MarketCalendar

pub fn cache(self, ttl: Duration) -> Self

Cache responses for ttl instead of the default 60 seconds, deduplicating concurrent identical requests.

pub fn cache_forever(self) -> Self

Cache responses for the handle’s lifetime instead of the default 60 seconds.

pub fn no_cache(self) -> Self

Disable caching — every call fetches fresh data.

impl MarketCalendar

pub async fn fetch( &self, kind: CalendarKind, from: &str, to: &str, ) -> Result<Vec<MarketCalendarEntry>>

Fetch a calendar of kind over [from, to] (YYYY-MM-DD dates).

Cached per (kind, from, to).

pub async fn earnings( &self, from: &str, to: &str, ) -> Result<Vec<MarketCalendarEntry>>

Earnings releases scheduled or reported over [from, to].

pub async fn ipos( &self, from: &str, to: &str, ) -> Result<Vec<MarketCalendarEntry>>

Initial public offerings over [from, to].

pub async fn dividends( &self, from: &str, to: &str, ) -> Result<Vec<MarketCalendarEntry>>

Dividend payments over [from, to].

pub async fn splits( &self, from: &str, to: &str, ) -> Result<Vec<MarketCalendarEntry>>

Stock splits over [from, to].

pub async fn economic( &self, from: &str, to: &str, ) -> Result<Vec<MarketCalendarEntry>>

Macro-economic releases over [from, to].

pub async fn holidays(&self) -> Result<Vec<MarketCalendarEntry>>

Upcoming market holidays and early closes. Providers return their upcoming set, so no date range is taken.

pub async fn market_status(&self) -> Result<Vec<MarketCalendarEntry>>

Live open/closed status per exchange. A snapshot rather than a dated event, so no date range is taken. Currently Alpha Vantage only.