Next-48h catalyst calendar

CEV-OS / Data API / Next-48h catalyst calendar

CEV-OS Data API · last updated 2026-11-04. Status: live. Version 1.

Use this when you need to know whether the next hours contain a scheduled high-impact event: US macro releases, FOMC, Treasury auctions, SEC-filed or estimated earnings, and options expiry, each with an impact tier.

What it is

One merged, time-sorted list for the next N hours (default 48). Macro/Fed from official agency schedules; Treasury auctions as announced on TreasuryDirect; earnings are sec_filed once an 8-K Item 2.02 is accepted by EDGAR, otherwise estimated from the issuer's own SEC filing history (labelled estimated with a confidence); monthly/quarterly options expiry computed. Earnings cover the S&P 100 + NASDAQ-100 union. No prices, no vendor calendars.

Endpoints

REST: GET /v1/catalysts on https://api.cev-os.com
Legacy host (same service): GET /v1/catalysts on https://cev-os.com
MCP tool: get_catalysts on https://mcp.cev-os.com/mcp

Parameters

Query parameters for `GET /v1/catalysts`
Name	Type	Description	Constraints
`hours`	integer	Look-ahead window in hours (1-168, default 48).	example 48; min 1; max 168
`kinds`	string	Comma-separated filter: macro, fed, treasury_auction, earnings, options_expiry.	example macro,fed
`min_tier`	string	Lowest impact tier to include.	enum: low, medium, high
`include_estimated`	boolean	Include estimated (not yet SEC-confirmed) earnings dates (default true).	—

Example request

No account and no key. Query values below are the examples or defaults from the registry. An optional free key (header x-api-key) raises the limits; create one at https://cev-os.com/#api_keys after signing in with a verified email (Google sign-in is already verified).

curl -s "https://api.cev-os.com/v1/catalysts?hours=48&kinds=macro%2Cfed"

Example response

Every /v1 response is a JSON envelope (schema_version, product, timestamps, license, attribution, data). The registry example is the data member:

{
  "count": 2,
  "catalysts": [
    {
      "id": "macro:fomc_decision:2026-10-28",
      "kind": "fed",
      "title": "FOMC Rate Decision",
      "at": "2026-10-28T18:00:00.000Z",
      "at_et": "Wed, Oct 28, 2026, 2:00 PM ET",
      "impact_tier": "high",
      "basis": "official"
    },
    {
      "id": "ust:91282CRR4:2026-10-22",
      "kind": "treasury_auction",
      "title": "5-Year Note auction",
      "at": "2026-10-22T17:00:00.000Z",
      "impact_tier": "medium",
      "basis": "announced"
    }
  ]
}

Update frequency

Macro from the scheduled snapshot; Treasury auctions cached 1 h; SEC 8-K Item 2.02 polled every 2 min 6 AM-9 PM ET weekdays and history refreshed daily.

Public cache: 300 seconds (Cache-Control: public, max-age=300).

Sources, license and usage

License status: cleared. US Government works (BLS, BEA, Census, Fed, DOL, Treasury, SEC) plus computed expiry dates and ISM release dates.

Underlying sources
Source	License	commercialOk	Terms
U.S. Bureau of Labor Statistics	US Government work (public domain); cite BLS	true	https://www.bls.gov/opub/copyright-information.htm
U.S. Bureau of Economic Analysis (incl. NIPA data files, keyless): GDP, PCE price, trade balance	US Government work (public domain); cite BEA; not endorsed or certified by BEA	true	https://www.bea.gov/help/faq/147
U.S. Census Bureau (incl. Advance Monthly Retail Trade time series, keyless)	US Government work (public domain)	true	https://www.census.gov/about/policies/open-gov/open-data.html
Federal Reserve Board (FOMC statements, open market operations page)	US Government work (public domain)	true	https://www.federalreserve.gov/disclaimer.htm
U.S. Department of Labor (weekly claims release)	US Government work (public domain)	true	—
Institute for Supply Management (dates only)	Release DATES only; PMI values are proprietary and NOT redistributed	true	—
U.S. Department of the Treasury, TreasuryDirect (announced auctions)	US Government work (public domain)	true	—
SEC EDGAR (8-K Item 2.02 filings)	US Government work (public domain); SEC fair-access rules followed (declared User-Agent, <10 req/s)	true	https://www.sec.gov/os/accessing-edgar-data
Computed options-expiry dates (standard third-Friday rule, NYSE holiday calendar)	Computed by cev-os (facts, no third-party data)	true	—

Attribution (show this wherever you display the data):

Sources: BLS, BEA, U.S. Census Bureau, DOL, Federal Reserve Board, U.S. Treasury (TreasuryDirect), SEC EDGAR. This service uses BEA data but is not endorsed or certified by BEA.

Privacy class: public-derived. Access: public. Price: free (price is null; pay-per-call is not active).

Gaps

Fed speeches are not included yet.
Earnings dates before the 8-K is filed are estimates from filing history, not company-confirmed dates.
No historical average move (needs licensed prices).

Data API hub (all products, limits, license notes)
MCP Registry listing com.cev-os/data
OpenAPI 3.1
Machine product list: /v1/products

Reference data, not investment advice.