Documentation

How CatalystCal is built — where every event comes from, how the impact score is computed, and how the calendar stays current.

The 30-second version

CatalystCal keeps one timeline of market catalysts: earnings dates, macro releases (CPI, payrolls, jobless claims), Treasury auctions, FOMC meetings and Fed speakers. Earnings come from company IR announcements merged with Yahoo Finance's calendar; the macro and central-bank schedule is built from official agency calendars and cross-checked daily against a live market-calendar feed; auctions come straight from the U.S. Treasury. Everything is rebuilt automatically once a day, and every projected date is labeled (est.) until its source confirms it.

Browse the docs

Earnings datesIR announcements + Yahoo Finance, source stamps, BMO/AMC timing, (est.) labels. Macro, central banks & auctionsBLS / BEA / Census calendars, ForexFactory cross-check, Treasury FiscalData, the Fed. The impact scoreThe full rule table behind the 5–95 score on every event card. Freshness & quotesWhat updates daily, how (est.) dates get confirmed, where quotes come from. Alerts & the weekly digestPersonalized alert emails, saved-event reminders and the Monday digest. Corrections & disclaimerReport a wrong date, and the standard caveats, stated plainly.

Sources at a glance

What	Source	How it's fetched
Earnings dates	Company IR announcements	Human-tracked; wins over projections
Earnings breadth	Yahoo Finance earnings calendar	API (JSON via yfinance), polled daily
Upcoming week's macro	ForexFactory weekly feed	API (HTTPS GET, JSON, no key), once daily
Treasury auctions	U.S. Treasury FiscalData	API (HTTPS GET, JSON, no key), once daily
FOMC meetings	federalreserve.gov calendar	Hand-transcribed (no API exists)
Yearly macro schedule	BLS · BEA · Census schedule pages	Hand-transcribed (no API exists)
Market quotes	Yahoo Finance · Stooq	Server-side fetch at page view

Mechanism detail per source — endpoints, fields, filters and failure handling — is documented on the earnings and macro pages.

Contact

Wrong date, missing event, or a question about methodology — email [email protected]. Corrections get fixed the same day.