Economic Calendar Tracker — Official US Release Schedule, No Login

Build a scheduled economic-calendar API feed for currency and market workflows. Call the Actor on your schedule, filter by countries and impactLevels, and consume upcoming US releases at their official times. Each event row carries a stable canonical_event_id for deduplication, source_agency, and source_attribution for the schedule's provenance and licence acknowledgement. official_source_url and official_license identify an enriched actual when available; actual values appear when the agency publishes them.

The paid schedule's strongest coverage is US federal releases from BLS, BEA, Census, DOL, the Fed, and EIA. Limited UK, euro-area, Canadian and Australian official rows are available; there is no JPY official schedule. It does not supply private-survey or consensus forecasts, and historical lookback is limited to about eight weeks. A Console prefill run across all countries may return roughly 10 events where the former feed returned 86.

Quick start

For a scheduled/API call that follows high-impact USD releases this week:

{"dateRange":"this_week","countries":["USD"],"impactLevels":["high"]}

Use dateFrom and dateTo for an exact window, or limit to bound the returned rows. A quiet week may legitimately return no upcoming events.

One official-source event dataset item from 2026-10-22 (selected fields shown; live values change):

{"title":"CPI y/y","country":"GBP","impact":"high","date_iso":"2026-10-21T02:00:00-04:00","forecast":null,"previous":null,"actual":"3.5%","event_category":"inflation","data_source":"official"}

title names the release or meeting; country is its region or currency code. impact is the actor's rule-based importance level. date_iso is the official scheduled time. previous and actual may be null until an agency publishes the value. Because there is no licensed consensus forecast, forecast and forecast-dependent direction, change, and surprise fields remain null in official-source rows. event_category groups similar events, and data_source is official. canonical_event_id identifies the event across runs; source_agency and official_* fields retain schedule provenance and licence attribution. actual_source, actual_fetched_at, and actual_license identify an official value when present. The ECB Main Refinancing Rate series is shadow-only because its effective date need not be the decision date. BEA's current NIPA series has no release-vintage marker, so only the advance GDP estimate can fill actual on its release day. A trailing week_outlook summary item is also emitted.

With an owner-configured Census key, USD Retail Sales m/m and Core Retail Sales m/m use the Census MARTS published seasonally adjusted monthly percent-change series (MPCSM), categories 44X72 and 44Y72 (excluding autos), respectively.

Selected AUD releases use the keyless Australian Bureau of Statistics Data API: seasonally adjusted Labour Force employment change and unemployment rate, monthly CPI and trimmed-mean CPI, and quarterly Wage Price Index. These are exact-series matches, not estimates. If the current reference period has not appeared in the API yet, actual remains null. ABS values carry the attribution Source: Australian Bureau of Statistics, CC BY 4.0.

Limits

Results depend on agency calendars; a short date window may contain no events. USD federal coverage is the strongest. UK, euro-area, Canadian and Australian rows are limited to mapped official calendars; JPY and other currencies have no licensed official schedule here. Unreleased events keep a null actual. Alerts require valid Telegram or webhook settings.

Pricing

Pay-per-event:

Event	Price
Actor start (charged by Apify, one per GB of run memory)	$0.001
Economic event returned	$0.002

The first 25 events per account (one-time trial, not per run or per day) are free. Example: the first default run of the day (this week, ~75 events) = 50 × $0.002 + start = $0.101; a high-impact-only run later the same day charges every returned event.

Use from AI agents (MCP)

Connect your agent to Apify's official MCP server with an Apify token. Select the Actor tool gochujang/economic-calendar-tracker, pass the Quick start JSON as input, then retrieve its dataset items through the MCP server. No separate gateway is needed.

---

Keywords: economic calendar API, official US release schedule, BLS calendar, BEA calendar, Federal Reserve calendar, CPI release dates, NFP release dates, FOMC dates, macro data API, central bank calendar, no login economic calendar

⚡ Run in 30 seconds

Click Start with default settings — returns this week's supported official releases sorted by date. Each row includes country, day of week, impact level, agency attribution, and any published actual.

---

Note (2026-10): the legacy source selector is ignored; every selection uses the official schedule.

---

Why traders choose this over free alternatives

Feature	Free scrapers	This actor
Custom date range (any dateFrom/dateTo)	❌	✅
Up to 8 weeks historical data	❌	✅
day_of_week field (Monday / Friday…)	❌	✅
Official release time and agency attribution	❌	✅
Crypto-relevance score (0–10)	❌	✅
Category filter (monetary_policy, inflation, employment…)	❌	✅
Published actuals when available	❌	✅
Telegram alerts + webhook (Zapier, Make, n8n)	❌	✅
Timezone conversion (date_local field)	❌	✅
Source agency tag (Fed, BLS, BEA, ECB…)	❌	✅

---

Why this exists

Macro events drive the biggest single-day moves in every asset class. An FOMC decision or CPI print can swing crypto and equities 3–5% in minutes. Pro traders avoid holding through these events; quants build economic calendars into their backtests.

This actor turns supported official agency schedules into structured rows with filters, sorting, and Telegram alerts.

---

What you get per row

Field	Example	Notes
title	Core CPI m/m	event name
country	USD	currency / region
impact	high	low / medium / high / holiday
date_iso	2026-06-10T08:30:00-04:00	event time in ET
day_of_week	Tuesday	Monday–Sunday — useful for weekly aggregation
forecast	null	retained for schema compatibility
previous	0.4%	prior reading
actual	null	populated after release
actual_source	null	provenance of an enriched actual; null when the actual comes from the calendar feed
actual_fetched_at	null	UTC time an enriched actual was fetched; null when absent
actual_license	null	official-source attribution when an official value fills a missing feed actual
surprise_direction	null	retained for schema compatibility
surprise_pct	null	retained for schema compatibility
event_category	inflation	monetary_policy / inflation / employment / growth / …
forecast_direction	null	retained for schema compatibility
forecast_change_pct	null	retained for schema compatibility
crypto_relevance	9	0–10 score of how much this event moves crypto
source_agency	BLS	short code of the releasing agency
canonical_event_id	USD_CPI	stable cross-run identifier for joins/dedup
hours_until_event	3.5	hours until event fires (negative = past)
is_today	true	event is on today's date
is_upcoming_24h	true	event fires within the next 24 hours
has_actual	false	whether the actual result has been released
date_local	2026-06-10T17:30:00+09:00	event time in your local timezone (only when timezone input is set)
data_source	official	official schedule source

Sample output (1 row)

{
  "title": "Core CPI m/m",
  "country": "USD",
  "impact": "high",
  "date_iso": "2026-09-10T08:30:00-04:00",
  "day_of_week": "Wednesday",
  "forecast": null,
  "previous": null,
  "actual": null,
  "surprise_direction": null,
  "surprise_pct": null,
  "forecast_direction": null,
  "forecast_change_pct": null,
  "event_category": "inflation",
  "canonical_event_id": "USD_CORE_CPI",
  "source_agency": "BLS",
  "source_agency_full": "US Bureau of Labor Statistics",
  "crypto_relevance": 9,
  "hours_until_event": 14.5,
  "is_today": true,
  "is_upcoming_24h": true,
  "has_actual": false,
  "date_local": "2026-09-10T21:30:00+09:00",
  "data_source": "official"
}

---

Impact levels

Impact	What to expect
high	Top-tier events (FOMC, NFP, CPI, GDP, ECB rate decision). Expect 1–5% moves in FX, indices, and crypto
medium	Tier-2 mapped official releases, such as retail sales and durable goods. Often 0.5–1% moves
low	Speeches, secondary data. Usually noise unless they break trend
holiday	Bank holiday — thinner liquidity all day

---

Use cases

1. Algo-trading signal pipeline — Filter impact: high + crypto_relevance ≥ 7 → feed into your trading bot as a risk-off gate before FOMC / CPI prints
2. Automated release alerts — Webhook to Slack / Discord before a high-impact event: "Official CPI release in 2 hours"
3. Macro research & dashboards — Pull the weekly official calendar into Google Sheets, Notion, or Airtable via Make / Zapier. Group events by agency, category, and published actual.
4. Position management — Don't get caught in a directional trade through high-impact events. Schedule every Monday to get the week's risk calendar.
5. Volatility trading — is_upcoming_24h: true + impact: high → buy straddles ahead of FOMC; sell after the print
6. Historical release review — Pull a custom date range (up to 8 weeks) to align official release times and published actuals with your market data
7. Policy-event calendar — Filter eventCategories to monetary_policy to watch scheduled rate decisions and meetings
8. Risk dashboard — Daily Telegram digest of upcoming high-impact events

---

Input Parameters

Source selection (v1.9)

Parameter	Type	Default	Description
source	string	legacy value (ignored)	Legacy input, ignored: kept only so saved tasks keep validating. Every value, including the default, returns the official agency schedule

Date range

Parameter	Type	Default	Description
dateFrom	string	—	Only return events on/after this date (ISO 8601, e.g. 2026-01-01). Works across weeks.
dateTo	string	—	Only return events on/before this date (ISO 8601, e.g. 2026-01-31).
dateRange	string	—	Convenience preset: this_week, next_week, two_weeks, last_week, last_month, last_3_months. Overrides previousWeeks.
includeNextWeek	boolean	false	Include next week's events in addition to this week
previousWeeks	integer	0	Fetch N past weeks of data (1 = last week, 4 = last month, max 8)

Filters

Parameter	Type	Default	Description
highImpactOnly	boolean	false	Shorthand to return only high-impact events
excludeHolidays	boolean	false	Filter out bank holidays
countries	array	all	Filter by currency/country codes (e.g. ["USD", "EUR"])
impactLevels	array	all	Filter by impact: high, medium, low, holiday
titleSearch	string	—	Keyword filter on event title (e.g. CPI, NFP, FOMC)
minCryptoRelevance	integer	0	Only return events with crypto relevance ≥ N (0–10). Use 7 for FOMC/CPI/NFP/PCE only
eventCategories	array	all	Filter by category: monetary_policy, inflation, employment, growth, trade, sentiment, retail, housing, energy, credit
forecastDirection	string	—	Legacy forecast-dependent filter; official-source rows do not satisfy it, so setting it normally returns no events

Output

Parameter	Type	Default	Description
timezone	string	—	IANA timezone (e.g. Asia/Seoul). Adds date_local field to each row
sortBy	string	date_asc	Sort order: date_asc, date_desc, impact_desc, crypto_relevance_desc
limit	integer	500	Maximum events to return

Alerts & integrations

Parameter	Type	Default	Description
alertOnImpacts	array	—	Send Telegram alert for matching impact levels
alertMinHoursUntil	integer	—	Only alert for events at least this many hours away (lower bound of alert window)
alertMaxHoursUntil	integer	—	Only alert for events within this many hours (upper bound). Set to 2 to catch imminent events only
telegramBotToken	string	—	Bot token for Telegram alerts
telegramChatId	string	—	Chat ID for Telegram alerts
webhookUrl	string	—	POST all matching events as JSON to this URL (Zapier, Make, n8n, Slack, etc.)

---

More input examples

Default — all this-week events

{}

This + next week, high-impact only

{
  "includeNextWeek": true,
  "impactLevels": ["high"],
  "sortBy": "date_asc"
}

USD + EUR + GBP only

{
  "countries": ["USD", "EUR", "GBP"],
  "sortBy": "impact_desc"
}

Crypto-relevant events only

{
  "countries": ["USD", "EUR"],
  "highImpactOnly": true,
  "minCryptoRelevance": 7,
  "sortBy": "crypto_relevance_desc"
}

Custom date range (within the supported lookback)

{
  "dateFrom": "2026-10-01",
  "dateTo": "2026-10-24",
  "highImpactOnly": true
}

Last 4 weeks for backtesting

{
  "dateRange": "last_month",
  "highImpactOnly": true,
  "countries": ["USD"],
  "sortBy": "date_asc"
}

Monetary-policy release schedule

{
  "eventCategories": ["monetary_policy", "inflation"],
  "countries": ["USD", "EUR"],
  "sortBy": "date_asc"
}

Daily alert on high-impact events

{
  "alertOnImpacts": ["high"],
  "telegramBotToken": "YOUR_BOT_TOKEN",
  "telegramChatId": "YOUR_CHAT_ID"
}

Imminent-event alert (events in the next 2 hours only)

{
  "alertOnImpacts": ["high"],
  "alertMaxHoursUntil": 2,
  "telegramBotToken": "YOUR_BOT_TOKEN",
  "telegramChatId": "YOUR_CHAT_ID"
}

Pre-market window (events 1–4 hours from now)

{
  "alertOnImpacts": ["high", "medium"],
  "alertMinHoursUntil": 1,
  "alertMaxHoursUntil": 4,
  "telegramBotToken": "YOUR_BOT_TOKEN",
  "telegramChatId": "YOUR_CHAT_ID"
}

Webhook to Slack/Zapier

{
  "highImpactOnly": true,
  "webhookUrl": "https://hooks.zapier.com/hooks/catch/..."
}

---

Supported countries

The official schedule currently covers mapped releases from these regions; coverage is not complete for every currency:

Code	Country / Region
USD	United States
EUR	Eurozone (ECB)
GBP	United Kingdom
CAD	Canada
AUD	Australia

There is no JPY official schedule. Other currencies absent from this table are not served.

---

Data sources

• US federal agencies — BLS, BEA, Census, DOL, the Federal Reserve, and EIA supply scheduled releases and published actuals.
• Other official agencies — mapped releases from ONS, Eurostat/ECB, Statistics Canada/BoC, ABS/RBA and other licensed calendars; coverage is limited and varies by week.

---

Works Great With

Combine this actor with others from the same author to build a complete macro intelligence stack:

• Stock Earnings Calendar Tracker — Combine macro events with earnings reports for a complete market calendar. Schedule both to run every Monday and get the full week's risk picture in one pipeline.
• US Treasury Yield Curve Tracker — Track how rate decisions impact the yield curve in real-time. Pair FOMC and CPI release dates and published actuals from this actor with live yield curve data to study bond market reactions.
• Unusual Options Activity Scanner — Options traders use economic events to time entries. Run this actor first to flag upcoming high-impact events, then scan for unusual options positioning in the same assets.
• Crypto ETF Flow Tracker — Institutional ETF flows often spike around macro prints. Layer CPI, NFP, and FOMC data from this actor on top of daily ETF inflow data to explain and anticipate flow moves.

---

Schedule This Actor

Set it and forget it — run once a week, every Monday morning, before market open.

Apify Console → Schedules → + New Schedule:

Field	Value
Actor	Economic Calendar Tracker
Cron	0 7 * * 1 (every Monday 7:00 UTC)
Input	{"source": "both", "includeNextWeek": true, "highImpactOnly": true}

Connect the output to a Webhook (Slack, Discord, email, Google Sheets) under Integrations in the Actor settings.

For daily pre-market alerts on imminent events:

Field	Value
Cron	0 6 * * 1-5 (weekdays 6:00 UTC)
Input	{"highImpactOnly": true, "alertOnImpacts": ["high"], "alertMaxHoursUntil": 8, "telegramBotToken": "...", "telegramChatId": "..."}

---

Related actors (same author)

• Treasury Yield Curve Tracker — Curve response to macro prints
• Stock Earnings Calendar Tracker — Single-name earnings calendar
• Crypto ETF Flow Tracker
• Stablecoin Supply Tracker

---

Feedback

A short review helps macro traders find it: Leave a review on Apify Store