Corporate events: US SEC 8-K events, and official stock-exchange
releases of Finnish and Swedish listed companies (from 2026-01-01:
inside information such as profit warnings and large orders, management
changes, tender offers, reports). Also the report calendar.
Scopes:
- ``"company"`` (default): one company's events, newest first;
``summarise=True`` returns per-type counts instead. Set
since/until around a date to explain a price move.
- ``"cross_company"``: events across companies filtered by event type,
``index="sp500"``, ``industry`` (substring), ``companies`` list or
``market="nordic"`` (default US).
- ``"calendar"``: scheduled interim / annual report dates in
``since_date``..``until_date`` (default today .. +14 days, max 120),
optional ``company`` / ``market``; ``published: true`` once the report
is in Clarifo, ``include_published=False`` keeps only upcoming. Never
extend the calendar with guessed dates. ``companies`` (up to 30) or
``portfolio_id`` (from portfolios) gives several companies in one
call; ``coverage`` then says per company why it has no date
(later_date_known, not_announced_yet, no_calendar_coverage).
- ``"offerings"``: one US company's priced offerings (424B4 / 424B1
prospectus), the IPO first, then follow-ons newest first.
- ``"ipos"``: recent US IPOs market-wide, newest first (default since:
90 days); SPACs are flagged ``is_spac``.
Args:
company: Name, ticker or CIK; required for company scope.
since_date / until_date: YYYY-MM-DD (default since: 365 days for
company, 30 days for cross_company, 90 days for ipos; none for
offerings).
event_types: acquisition, disposition, executive_change,
director_change, material_contract, default, bankruptcy,
covenant_breach, amendment, auditor_change, earnings,
guidance_update, other; Nordic also inside_information,
profit_warning, tender_offer, capital_event, major_shareholding,
insider_trade, share_repurchase, agm. Nordic profit warnings and
guidance changes are filed as inside information: read the titles.
item_numbers: Raw 8-K items, e.g. ["2.01"] (US).
limit: Max 500 (ignored when summarising).
market: "us" or "nordic".
portfolio_id: Calendar scope: the user's portfolio whose companies
to list (from portfolios).
materiality: Nordic only: "high" (inside information, tender offers,
management changes; cross_company default), "medium" (+ reports,
capital events, holdings; company default) or "low" (everything).
Returns ``events[]`` (company and cross_company), ``summary`` (summarise)
or calendar ``events[]`` (expected_date, period_label, confirmed,
published). Nordic events carry ``title``, ``category``, ``materiality``,
``excerpt`` and ``source_url`` to the filed release (cite it).
``offerings[]`` / ``ipos[]``: offering_type, pricing_date,
price_per_share, price_range, shares_offered, gross_proceeds_usd,
exchange, ticker, underwriters, registration (S-1 / F-1), source_url;
no coverage: ``diagnostic.reason = "no_offerings_data_yet"``.