Is it out yet? US macro release calendar

The CEV-OS Data API publishes official US release times and, after a release, actual and prior values. Two related products answer the usual questions: when is it scheduled? (GET /v1/macro-calendar) and has it been published yet? (GET /v1/release-status). A third, GET /v1/catalysts, lists scheduled high-impact events in the next hours.

In-app Macro Calendar stays login-gated. This page is the public explainer. Last sample fetch 2026-11-03T01:22:33.718Z.

Release list

The 15 event types on `/v1/macro-calendar`
event	Name	Agency	Schedule
`cpi`	Consumer Price Index (CPI)	BLS	schedule
`ppi`	Producer Price Index (PPI)	BLS	schedule
`employment_situation`	Employment Situation (Nonfarm Payrolls)	BLS	schedule
`jolts`	Job Openings and Labor Turnover Survey (JOLTS)	BLS	schedule
`eci`	Employment Cost Index (ECI)	BLS	schedule
`gdp`	Gross Domestic Product (GDP)	BEA	schedule
`pce`	Personal Income and Outlays (PCE Price Index)	BEA	schedule
`retail_sales`	Advance Monthly Retail Sales	Census Bureau	schedule
`jobless_claims`	Unemployment Insurance Weekly Claims	DOL	schedule
`fomc_decision`	FOMC Rate Decision	Federal Reserve	schedule
`fomc_minutes`	FOMC Minutes	Federal Reserve	schedule
`ism_manufacturing`	ISM Manufacturing PMI	ISM	schedule
`ism_services`	ISM Services PMI	ISM	schedule
`trade_balance`	U.S. International Trade in Goods and Services (Trade Balance)	Census Bureau / BEA	schedule
`productivity`	Productivity and Costs	BLS	schedule

Freshness lag

The calendar snapshot is refreshed on weekdays every 15 minutes from 8:00–15:45 ET, and every 3 hours otherwise. It is flagged stale after 6 hours.
Actual values come from the official publishers (BLS Public Data API, BEA NIPA files, Census MARTS, DOL claims, Federal Reserve Board, Census/BEA trade page). They can lag a release by up to about 30 minutes.
The release-status watcher polls about once a minute from 8:00 AM–2:59 PM ET on weekdays. first_seen_at therefore has about one-minute granularity.
The calendar product does not use or store FRED data. FRED appears only on the separate macro-regime product.
consensus is always null. No free consensus source allows redistribution, and none is invented.

Dated sample from the live API

Fetched 2026-11-03T01:22:33.718Z from GET /v1/macro-calendar?event=cpi,fomc_decision&limit=4. Trimmed to status and printed values:

{
  "schema_version": "1.0",
  "product": "macro-calendar",
  "generated_at": "2026-11-03T01:22:33.718Z",
  "generated_at_et": "Mon, Nov 2, 2026, 8:22 PM ET",
  "as_of": "2026-11-02T23:00:33.683Z",
  "data": {
    "count": 4,
    "events": [
      {
        "id": "cpi:2026-10-14",
        "eventType": "cpi",
        "name": "Consumer Price Index (CPI)",
        "releaseAtEt": "Wed, Oct 14, 2026, 8:30 AM ET",
        "status": "released",
        "consensus": null,
        "actual": { "display": "+0.6% m/m" },
        "prior": { "display": "+0.4% m/m" },
        "dataSource": { "name": "U.S. Bureau of Labor Statistics, Public Data API", "retrievedAt": "2026-11-02T20:15:13.837Z" }
      },
      {
        "id": "fomc_decision:2026-10-28",
        "eventType": "fomc_decision",
        "name": "FOMC Rate Decision",
        "releaseAtEt": "Wed, Oct 28, 2026, 2:00 PM ET",
        "status": "released",
        "actual": { "display": "3.75–4.00%" }
      },
      {
        "id": "cpi:2026-11-10",
        "eventType": "cpi",
        "name": "Consumer Price Index (CPI)",
        "releaseAtEt": "Tue, Nov 10, 2026, 8:30 AM ET",
        "status": "scheduled",
        "actual": null,
        "prior": { "display": "+0.6% m/m" }
      },
      {
        "id": "fomc_decision:2026-12-09",
        "eventType": "fomc_decision",
        "name": "FOMC Rate Decision",
        "releaseAtEt": "Wed, Dec 9, 2026, 2:00 PM ET",
        "status": "scheduled"
      }
    ]
  }
}

Reading CPI and FOMC windows from a bot

This is a data-filter pattern, not trading advice. A process that should stay idle around scheduled high-impact US releases can:

Call GET /v1/catalysts?hours=24&kinds=macro,fed&min_tier=high.
If the list contains a CPI, payrolls or FOMC event whose at is still ahead (or just passed), skip placing new orders until the window ends.
Optionally confirm publication with GET /v1/release-status?event=cpi,fomc_decision and wait until state is out (or out_untimed).

How long to wait after out is a policy you choose. The API only reports schedule, detection time and printed values.

Related: Data API hub, quickstart, OpenAPI.