Economic Calendar Tracker — ForexFactory, No Login

ForexFactory economic calendar API — no login, no API key, no scraping headaches. FOMC, CPI, NFP, PCE, GDP, PMI, ECB / BOJ / BOE / Fed rate decisions, OPEC. Custom date range, surprise score (beat/miss/inline), crypto relevance score, hawkish/dovish signal, webhook + Telegram alerts. First 25 events per run free.

Keywords: ForexFactory economic calendar, economic calendar API, forex economic calendar, macro events scraper, FOMC calendar, CPI scraper, NFP data, ECB calendar, interest rate calendar, central bank calendar, macro data API, no login economic calendar

⚡ Run in 30 seconds

Click Start with default settings — returns this week's full macro calendar sorted by date. Each row includes country, day of week, impact level (high/medium/low), forecast, prior value, surprise direction, and crypto-relevance score.

Price comparison vs other Apify actors

Actor	Price per event	Surprise score	Crypto relevance	Webhook/Telegram
This actor	$0.002	✅	✅	✅
scrapemint/forexfactory-economic-calendar	$0.015	❌	❌	❌
pintostudio/economic-calendar-data-investing-com	varies	❌	❌	❌

7.5× cheaper than the next alternative — same ForexFactory data, far more features.

Why traders choose this over free alternatives

Feature	Free ForexFactory scrapers	This actor
Custom date range (any dateFrom/dateTo)	❌	✅
Up to 8 weeks historical data	❌	✅
day_of_week field (Monday / Friday…)	❌	✅
Surprise direction (beat/miss/inline)	❌	✅
Crypto-relevance score (0–10)	❌	✅
Category filter (monetary_policy, inflation, employment…)	❌	✅
Forecast direction filter (hawkish/dovish signal)	❌	✅
Telegram alerts + webhook (Zapier, Make, n8n)	❌	✅
Timezone conversion (date_local field)	❌	✅
Source agency tag (Fed, BLS, ECB, BOJ…)	❌	✅

---

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.

Investing.com's calendar is gated behind a paywall. Bloomberg's ECO function costs $24,000/yr. ForexFactory's calendar is free and machine-readable but raw. This actor wraps it with sane filters, sorting, surprise scoring, and Telegram alerts — at $0.002 per event.

---

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	0.3%	consensus
previous	0.4%	prior reading
actual	null	populated after release
surprise_direction	beat	beat / miss / inline — actual vs forecast
surprise_pct	25.0	% deviation of actual from forecast
event_category	inflation	monetary_policy / inflation / employment / growth / …
forecast_direction	lower	higher / lower / unchanged (hawkish/dovish signal)
forecast_change_pct	-25.0	% change of forecast vs previous
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)

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": "0.2%",
  "previous": "0.3%",
  "actual": null,
  "surprise_direction": null,
  "surprise_pct": null,
  "forecast_direction": "lower",
  "forecast_change_pct": -33.33,
  "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"
}

---

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 (PMI, retail sales, 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 news alerts — Webhook to Slack / Discord on any high-impact event: "CPI in 2 hours, forecast lower than prior → possible dovish surprise"
3. Macro research & dashboards — Pull weekly calendar into Google Sheets, Notion, or Airtable via Make / Zapier. Track hawkish vs dovish signal counts by week.
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 backtesting — Pull any custom date range (up to 8 weeks) with actual vs forecast to build surprise-momentum strategies
7. Hawkish/dovish signal filter — Use forecastDirection: "higher" on monetary_policy events to pre-screen rate decision surprises
8. Risk dashboard — Daily Telegram digest of upcoming high-impact events
9. Calendar integration — Pipe to Google Calendar / Slack / Discord via webhook; use day_of_week for day-of-week aggregation
10. Quant research — Combine with Treasury Yield Curve Tracker to correlate macro events with yield curve shifts

---

Input Parameters

Parameter	Type	Default	Description
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	—	higher or lower — only events where forecast is higher/lower than previous (hawkish/dovish signal)

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
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.)

---

Quick start

Default — all this-week events

{}

This + next week, high-impact only

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

USD + EUR + JPY only

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

USD/EUR high-impact only, crypto-relevant events

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

Custom date range (any window)

{
  "dateFrom": "2026-07-01",
  "dateTo": "2026-07-31",
  "highImpactOnly": true
}

Last 4 weeks for backtesting (actual vs forecast surprise)

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

Hawkish signal detector — events where forecast > previous

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

High-impact only via importance shorthand (alias for impactLevels)

{
  "importance": ["high"],
  "countries": ["USD", "EUR", "JPY"],
  "sortBy": "date_asc"
}

3-month backtest dataset

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

Daily alert on high-impact events

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

Webhook to Slack/Zapier on any high-impact event

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

---

Supported countries & currency codes

ISO-2, ISO-3, and currency codes all work (auto-mapped):

Code	Country / Region	ISO-2 aliases
USD	United States	US, USA
EUR	Eurozone (ECB)	EU, DE, FR, IT, ES, NL, BE, AT, FI, IE, GR, PT
GBP	United Kingdom	GB, UK, GBR
JPY	Japan	JP, JPN
CAD	Canada	CA, CAN
AUD	Australia	AU, AUS
NZD	New Zealand	NZ, NZL
CHF	Switzerland	CH, CHE
CNY	China	CN, CHN
ALL	Multi-country (OPEC, G7, IMF, G20)	—

Note: Countries not tracked by ForexFactory (KR, IN, BR, MX, RU, SA, ZA, AR, TR, ID) return no events — use titleSearch to filter by event keyword instead.

---

Pricing

Pay-Per-Event: $0.002 per economic event returned. First 25 events per run are free.

Run	Events	Charged	Cost
This + next week, high-impact only	15–25	0	Free
USD/EUR only	20–30	0	Free
Default (this week, all)	~75	50	$0.10
4-week historical range (backtesting)	~300	275	$0.55

vs Bloomberg ECO function ($24,000/yr) or Trading Economics API ($89/mo) — 99% cheaper at any volume.

---

Automate with Apify Scheduler

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	{"includeNextWeek": true, "highImpactOnly": true}

Connect the output to a Webhook (Slack, Discord, email, Google Sheets) under Integrations in the Actor settings. Total cost: ~$0.015–$0.075/week.

---

Data source

ForexFactory JSON feed (provided by Fair Economy) — free, public, updated continuously.

---

Related actors (same author)

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

---

Feedback

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