Use
from and to (YYYY-MM-DD) to define a window, and limit/offset where
supported. Preserve nextOffset and the applied filters while paging. Earnings
and corporate feeds accept view=compact to omit display-only fields; source
detail remains available through their detail or linked source routes.
Filters differ by feed: inspect the API Reference or astreus api describe for
the exact country/company/status filters rather than passing a filter to every
calendar and assuming it was applied. Dates can be tentative, confirmed or
inferred; retain their evidence and timing status. Empty coverage is not proof
that a company has no event. Corporate-calendar coverage is primarily sourced
from 8-Ks and is not a complete dividend ledger.
get_calendar selects a feed and returns a bounded view;
get_calendar_event retrieves a specific event. The older astreus calendar <company> command reads that issuer’s filing-derived event timeline; it is a
different endpoint from the cross-company calendar feeds.
Economic headlines may withhold figures whose publisher’s redistribution rights
are not established for a tool. A scheduled event, a preliminary result and a
revised result represent different states; do not treat an estimate as a release.