Official Economic Calendar — Fed, ECB, BLS, Eurostat source data (no aggregators)

What does Official Economic Calendar do?

Official Economic Calendar collects upcoming and recent macroeconomic events and official published values directly from primary institutional feeds (Federal Reserve, BLS, BEA, Census Bureau, Treasury, FRED, ECB, Eurostat, ONS, and Bank of England). Official published values only — no crowd consensus forecasts. Third-party aggregator crowd or consensus forecasts are not included.

Use it to track CPI, Nonfarm Payrolls (NFP), GDP, PCE, FOMC meetings, rate decisions, Treasury auctions, and other market-moving releases directly from primary sources without reconciling ten different calendars yourself. Duplicate listings are consolidated while official source links and source-specific context are retained.

Why use an official economic calendar?

• Market research: Build a forward calendar for economic releases and central-bank decisions.
• Trading workflows: Pause or annotate automated strategies around scheduled announcements.
• News planning: Prepare coverage for CPI, employment, GDP, inflation, and policy events.
• Data pipelines: Export consistent JSON, CSV, Excel, or HTML records across regions.
• Auditability: Follow each event back to its official public source.

What economic calendar data can it extract?

Field	Type	Description
eventName	String	Normalized release or event title
eventType	String	Data release, policy meeting, auction, rates, or central-bank event
importance	String	Curated expected market impact: high, medium, low, or unrated
releaseDateTimeUtc	String	UTC timestamp when an exact release time is known
releaseDate	String	Release date when an exact time is unavailable
countryRegion	String	US, United Kingdom, Euro area, or EU
period	String	Reference month, quarter, year, or security term
metrics	Array	Official metric definitions and exact period-matched observations
valueStatus	String	Whether values were not requested, unsupported, pending, unavailable, partial, complete, or failed
sourceName	String	Official publishing institution
sourceUrl	String	Official page or feed link
status	String	Scheduled, published, cancelled, preliminary, or source-specific status

The full dataset also includes stable IDs, local release times, timezones, update timestamps, deduplication keys, and source-specific fields. Exact series codes and units live inside their corresponding metric instead of being ambiguously attached to the whole release. The Calendar overview is schedule-focused; use the separate Release values view when metric enrichment is relevant. Every run also writes a RUN_SUMMARY record with source health, warnings, and selection counts.

How to collect Fed, ECB, BLS, and Eurostat releases

1. Create a free Apify account if needed.
2. Open Official Economic Calendar and click Try for free.
3. Choose a date window and set Max events to cap the output.
4. Keep all sources enabled or narrow the run by source, region, or event type.
5. Leave Get release values enabled to surface official observations when available, or disable it for a schedule-only run.
6. Click Start, then download results from the Dataset tab.

Input

Parameter	Type	Default	Description
dateWindow	String	next_30_days	Past 30 + next 90 days, past-only, future-only, or custom dates
maxEvents	Integer	50	Maximum events selected across the full window; higher-importance events are retained first, capped at 5,000
minImportance	String	medium	Keep all events or require low, medium, or high expected market impact
getReleaseValues	Boolean	true	Enrich calendar events with exact official observations when available; BLS mappings cover CPI, Employment Situation (payrolls and unemployment), PPI Final Demand, and JOLTS
includeObservationSeries	Boolean	false	Also include supported standalone official series such as Treasury yields and Fiscal Data
sources	Array	All sources	Official institutions to include
regions	Array	All regions	US, UK, euro area, and EU filters
eventTypes	Array	All types	Event classifications to retain
customStartDate	String	—	Custom YYYY-MM-DD start date
customEndDate	String	—	Custom YYYY-MM-DD end date
debugMode	Boolean	false	Save bounded troubleshooting artifacts

Date-window presets are ordered for the common workflow: recent_and_next_90_days (past 30 + next 90), past_30_days, next_30_days, next_90_days, next_12_months, then custom.

Upcoming 90-day calendar

{
  "dateWindow": "next_90_days",
  "maxEvents": 500,
  "getReleaseValues": false
}

US releases with official metrics

{
  "dateWindow": "recent_and_next_90_days",
  "maxEvents": 250,
  "minImportance": "medium",
  "getReleaseValues": true,
  "regions": ["us"],
  "eventTypes": ["data_release"],
  "sources": ["bls", "bea", "census", "treasury"]
}

Custom central-bank calendar

{
  "dateWindow": "custom",
  "customStartDate": "2026-08-01",
  "customEndDate": "2026-12-31",
  "maxEvents": 200,
  "eventTypes": ["policy_meeting", "central_bank_event"],
  "sources": ["federal_reserve", "ecb", "bank_of_england"]
}

Output

Results are saved to the default dataset and can be downloaded as JSON, CSV, Excel, or HTML.

{
  "id": "bls:example-release-2026-08",
  "source": "bls",
  "sourceName": "U.S. Bureau of Labor Statistics",
  "sourceRecordId": "example-release-2026-08",
  "sourceUrl": "https://www.bls.gov/schedule/news_release/example.htm",
  "eventName": "Consumer Price Index",
  "eventType": "data_release",
  "importance": "high",
  "countryRegion": "US",
  "releaseDateTimeUtc": "2026-08-12T12:30:00.000Z",
  "releaseDateTimeLocal": "2026-08-12T08:30:00",
  "releaseDate": "2026-08-12",
  "releaseTime": "08:30",
  "releaseTimezone": "America/New_York",
  "sourceDateText": "August 12, 2026, 8:30 AM ET",
  "period": "July 2026",
  "status": "scheduled",
  "metrics": [
    {
      "metricId": "bls:CUSR0000SA0",
      "name": "Consumer Price Index for All Urban Consumers",
      "datasetCode": "CUSR0000SA0",
      "unit": "index 1982-84=100",
      "seasonalAdjustment": "seasonally adjusted",
      "precedingObservation": {
        "value": "320.8",
        "period": "June 2026"
      },
      "sourceUrl": "https://data.bls.gov/timeseries/CUSR0000SA0"
    }
  ],
  "valueStatus": "pending",
  "updateTimestamp": "2026-07-20T18:00:00.000Z",
  "dedupeKey": "consumer price index|2026-08-12|us",
  "scrapedAt": "2026-07-20T18:00:00.000Z",
  "sourceFields": {}
}

How much does Economic Calendar API cost?

This Actor uses pay-per-event pricing. A normalized schedule-only or metadata-only record is charged as a calendar-event; a record containing at least one exact official observation or preceding observation is charged as an enriched-release-event. Exact rates are shown in the Actor pricing panel before a run.

Use maxEvents, a shorter date window, and narrow source or region filters to keep cost and runtime predictable. Value enrichment performs extra work, so set getReleaseValues to false when schedule data alone is enough.

Tips

• Start with the next 30 or 90 days before requesting a long custom window.
• Filter by region to avoid collecting sources you do not need.
• Some institutions publish a date without an exact time; use releaseDate when releaseDateTimeUtc is unavailable.
• updateTimestamp is populated only when the official source provides a publication or update timestamp; scrapedAt separately records collection time.
• Scheduled releases may list expected metric definitions, but observations are omitted until they can be matched to that exact release and reference period.
• When maxEvents is reached, the Actor selects higher-importance events across the complete requested window before restoring chronological output order. unrated events remain included when minImportance is all.
• Read RUN_SUMMARY from the default key-value store to detect source degradation, importance filtering, result truncation, or a pay-per-event charge limit.
• Headline enrichment includes BLS payrolls and unemployment, BEA income/PCE spending and price indexes, Census retail sales, published FOMC target ranges, published ECB policy rates, and published Bank Rate decisions.
• Weekly US jobless-claims release dates are explicitly collected from FRED. Numeric claims observations are not currently attached to those events.
• Each adapter uses its proven official primary endpoint. If that endpoint is unavailable, the source reports a degraded warning rather than substituting another feed or institution.
• Debug mode is for troubleshooting and stores only bounded artifacts.

FAQ

Are official observations available for every release?

No. Calendar coverage is broader than metric coverage. valueStatus makes every case explicit, and the Actor enriches only its maintained exact mapping catalog. It does not claim to extract every table cell inside every institutional report.

Why can the same release appear on several official calendars?

Some aggregating institutions republish releases from origin agencies. The Actor consolidates matching events and favors the origin agency while retaining useful identifiers from the aggregate listing.

Can I use custom dates?

Yes. Select custom, provide both dates in YYYY-MM-DD form, and keep the range within the supported limits. Caps remain enforced to prevent unbounded runs.

Support

• Bugs and feature requests: use the Issues tab.
• Programmatic access: use the API tab.

Disclaimer: This Actor collects publicly available institutional calendar data. Verify critical dates and values against the linked official source before making financial or operational decisions. This is not financial advice.