Economic Calendar API - ForexFactory and FXStreet Events
Pricing
from $2.00 / 1,000 event trackeds
Economic Calendar API - ForexFactory and FXStreet Events
Get ForexFactory and FXStreet economic calendar events as JSON. Filter by date, country, impact, or event type; inspect forecasts, actual releases, and surprise indicators for macro monitoring.
Economic Calendar Tracker — ForexFactory + FXStreet, No Login
Track scheduled macroeconomic releases for analysts monitoring currencies and markets.
Quick start
Request one event from the current week; the source changes with time, but this bounded input normally completes in under two minutes:
{"source":"forexfactory","dateRange":"this_week","limit":1}
One event dataset item from the ForexFactory feed on 2026-10-04 (selected fields shown; live values change):
{"title":"OPEC-JMMC Meetings","country":"ALL","impact":"medium","date_iso":"2026-10-04T05:15:00-04:00","forecast":null,"previous":null,"actual":null,"event_category":"energy","data_source":"forexfactory"}
title names the release or meeting; country is its region or currency code. impact is the source's importance level. date_iso gives the scheduled time, while forecast, previous, and actual may be null. event_category groups similar events, and data_source identifies the feed. A trailing week_outlook summary item is also emitted.
Limits
Results depend on the upstream ForexFactory or FXStreet feed; a short date window may contain no events. ForexFactory country coverage is narrower than FXStreet's. Forecast and actual values can be missing before a release, and historical ForexFactory queries are limited by available weekly feeds. 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: ForexFactory economic calendar, FXStreet calendar API, 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, global economic calendar, emerging market events
⚡ 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, actual, surprise direction, and crypto-relevance score.
Two sources — maximum coverage (v1.9)
| Feature | ForexFactory | FXStreet | This actor (both) |
|---|---|---|---|
| G10 currencies (USD, EUR, JPY…) | ✅ | ✅ | ✅ |
| Emerging markets (KR, IN, BR, MX, CN, ZA…) | ❌ | ✅ | ✅ |
| Countries covered | ~12 | 60+ | 60+ |
| Actual values after release | ✅ | ✅ | ✅ |
| Event categories | ✅ | ✅ | ✅ |
| Reliability from server IPs | ✅ | ✅ | ✅ |
Set source to forexfactory (default, fast G10), fxstreet (60+ countries), or both (maximum coverage, deduplicated).
Why traders choose this over free alternatives
| Feature | Free scrapers | This actor |
|---|---|---|
| 60+ countries via FXStreet | ❌ | ✅ |
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.
ForexFactory covers G10 currencies, while FXStreet covers a wider range. This actor combines both feeds with filters, sorting, surprise scoring, 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 | 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) |
data_source | fxstreet | which source returned this event: forexfactory or fxstreet |
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","data_source": "forexfactory"}
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
- Algo-trading signal pipeline — Filter
impact: high+crypto_relevance ≥ 7→ feed into your trading bot as a risk-off gate before FOMC / CPI prints - Emerging market coverage — Use
source: fxstreetto get KR, IN, BR, MX, CN events not available in ForexFactory - Automated news alerts — Webhook to Slack / Discord on any high-impact event: "CPI in 2 hours, forecast lower than prior → possible dovish surprise"
- Macro research & dashboards — Pull weekly calendar into Google Sheets, Notion, or Airtable via Make / Zapier. Track hawkish vs dovish signal counts by week.
- Position management — Don't get caught in a directional trade through high-impact events. Schedule every Monday to get the week's risk calendar.
- Volatility trading —
is_upcoming_24h: true+impact: high→ buy straddles ahead of FOMC; sell after the print - Historical backtesting — Pull any custom date range (up to 8 weeks) with actual vs forecast to build surprise-momentum strategies
- Hawkish/dovish signal filter — Use
forecastDirection: "higher"onmonetary_policyevents to pre-screen rate decision surprises - Risk dashboard — Daily Telegram digest of upcoming high-impact events
- Global macro coverage — Use
source: bothto merge ForexFactory and FXStreet for 60+ country coverage with deduplication
Input Parameters
Source selection (v1.9)
| Parameter | Type | Default | Description |
|---|---|---|---|
source | string | forexfactory | Data source: forexfactory (G10, fast), fxstreet (60+ countries), both (maximum coverage, deduplicated) |
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 |
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
{}
FXStreet — 60+ countries including emerging markets
{"source": "fxstreet","highImpactOnly": true,"sortBy": "date_asc"}
Maximum coverage — both sources merged
{"source": "both","highImpactOnly": true,"sortBy": "impact_desc"}
This + next week, high-impact only
{"includeNextWeek": true,"impactLevels": ["high"],"sortBy": "date_asc"}
USD + EUR + JPY only
{"countries": ["USD", "EUR", "JPY"],"sortBy": "impact_desc"}
Crypto-relevant events only
{"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
{"dateRange": "last_month","highImpactOnly": true,"countries": ["USD"],"sortBy": "date_asc"}
Hawkish signal detector
{"eventCategories": ["monetary_policy", "inflation"],"forecastDirection": "higher","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
ForexFactory (source: forexfactory — default, fast):
| Code | Country / Region |
|---|---|
USD | United States |
EUR | Eurozone (ECB) |
GBP | United Kingdom |
JPY | Japan |
CAD | Canada |
AUD | Australia |
NZD | New Zealand |
CHF | Switzerland |
CNY | China |
FXStreet (source: fxstreet — 60+ countries including):
All of the above plus South Korea (KRW), India (INR), Brazil (BRL), Mexico (MXN), Russia (RUB), South Africa (ZAR), Turkey (TRY), Indonesia (IDR), Singapore (SGD), Hong Kong (HKD), Norway (NOK), Sweden (SEK), Denmark (DKK), Poland (PLN), Czech Republic (CZK), and 40+ more.
Data sources
- ForexFactory — Fair Economy JSON feed. G10 currencies. Fast, continuously updated.
- FXStreet — FXStreet Economic Calendar. 60+ countries. Actual values, event categories, broader coverage.
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 surprises from this actor with live yield curve data to spot bond market reactions instantly.
- 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