Economic Calendar API - ForexFactory and FXStreet Events avatar

Economic Calendar API - ForexFactory and FXStreet Events

Pricing

from $2.00 / 1,000 event trackeds

Go to Apify Store
Economic Calendar API - ForexFactory and FXStreet Events

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.

Pricing

from $2.00 / 1,000 event trackeds

Rating

0.0

(0)

Developer

Hojun Lee

Hojun Lee

Maintained by Community

Actor stats

1

Bookmarked

63

Total users

19

Monthly active users

2 days ago

Last modified

Categories

Share

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:

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

FeatureForexFactoryFXStreetThis actor (both)
G10 currencies (USD, EUR, JPY…)✅✅✅
Emerging markets (KR, IN, BR, MX, CN, ZA…)❌✅✅
Countries covered~1260+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

FeatureFree scrapersThis 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

FieldExampleNotes
titleCore CPI m/mevent name
countryUSDcurrency / region
impacthighlow / medium / high / holiday
date_iso2026-06-10T08:30:00-04:00event time in ET
day_of_weekTuesdayMonday–Sunday — useful for weekly aggregation
forecast0.3%consensus
previous0.4%prior reading
actualnullpopulated after release
surprise_directionbeatbeat / miss / inline — actual vs forecast
surprise_pct25.0% deviation of actual from forecast
event_categoryinflationmonetary_policy / inflation / employment / growth / …
forecast_directionlowerhigher / lower / unchanged (hawkish/dovish signal)
forecast_change_pct-25.0% change of forecast vs previous
crypto_relevance90–10 score of how much this event moves crypto
source_agencyBLSshort code of the releasing agency
canonical_event_idUSD_CPIstable cross-run identifier for joins/dedup
hours_until_event3.5hours until event fires (negative = past)
is_todaytrueevent is on today's date
is_upcoming_24htrueevent fires within the next 24 hours
has_actualfalsewhether the actual result has been released
date_local2026-06-10T17:30:00+09:00event time in your local timezone (only when timezone input is set)
data_sourcefxstreetwhich 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

ImpactWhat to expect
highTop-tier events (FOMC, NFP, CPI, GDP, ECB rate decision). Expect 1–5% moves in FX, indices, and crypto
mediumTier-2 (PMI, retail sales, durable goods). Often 0.5–1% moves
lowSpeeches, secondary data. Usually noise unless they break trend
holidayBank 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. Emerging market coverage — Use source: fxstreet to get KR, IN, BR, MX, CN events not available in ForexFactory
  3. Automated news alerts — Webhook to Slack / Discord on any high-impact event: "CPI in 2 hours, forecast lower than prior → possible dovish surprise"
  4. Macro research & dashboards — Pull weekly calendar into Google Sheets, Notion, or Airtable via Make / Zapier. Track hawkish vs dovish signal counts by week.
  5. Position management — Don't get caught in a directional trade through high-impact events. Schedule every Monday to get the week's risk calendar.
  6. Volatility trading — is_upcoming_24h: true + impact: high → buy straddles ahead of FOMC; sell after the print
  7. Historical backtesting — Pull any custom date range (up to 8 weeks) with actual vs forecast to build surprise-momentum strategies
  8. Hawkish/dovish signal filter — Use forecastDirection: "higher" on monetary_policy events to pre-screen rate decision surprises
  9. Risk dashboard — Daily Telegram digest of upcoming high-impact events
  10. Global macro coverage — Use source: both to merge ForexFactory and FXStreet for 60+ country coverage with deduplication

Input Parameters

Source selection (v1.9)

ParameterTypeDefaultDescription
sourcestringforexfactoryData source: forexfactory (G10, fast), fxstreet (60+ countries), both (maximum coverage, deduplicated)

Date range

ParameterTypeDefaultDescription
dateFromstring—Only return events on/after this date (ISO 8601, e.g. 2026-01-01). Works across weeks.
dateTostring—Only return events on/before this date (ISO 8601, e.g. 2026-01-31).
dateRangestring—Convenience preset: this_week, next_week, two_weeks, last_week, last_month, last_3_months. Overrides previousWeeks.
includeNextWeekbooleanfalseInclude next week's events in addition to this week
previousWeeksinteger0Fetch N past weeks of data (1 = last week, 4 = last month, max 8)

Filters

ParameterTypeDefaultDescription
highImpactOnlybooleanfalseShorthand to return only high-impact events
excludeHolidaysbooleanfalseFilter out bank holidays
countriesarrayallFilter by currency/country codes (e.g. ["USD", "EUR"])
impactLevelsarrayallFilter by impact: high, medium, low, holiday
titleSearchstring—Keyword filter on event title (e.g. CPI, NFP, FOMC)
minCryptoRelevanceinteger0Only return events with crypto relevance ≥ N (0–10). Use 7 for FOMC/CPI/NFP/PCE only
eventCategoriesarrayallFilter by category: monetary_policy, inflation, employment, growth, trade, sentiment, retail, housing, energy, credit
forecastDirectionstring—higher or lower — only events where forecast is higher/lower than previous (hawkish/dovish signal)

Output

ParameterTypeDefaultDescription
timezonestring—IANA timezone (e.g. Asia/Seoul). Adds date_local field to each row
sortBystringdate_ascSort order: date_asc, date_desc, impact_desc, crypto_relevance_desc
limitinteger500Maximum events to return

Alerts & integrations

ParameterTypeDefaultDescription
alertOnImpactsarray—Send Telegram alert for matching impact levels
alertMinHoursUntilinteger—Only alert for events at least this many hours away (lower bound of alert window)
alertMaxHoursUntilinteger—Only alert for events within this many hours (upper bound). Set to 2 to catch imminent events only
telegramBotTokenstring—Bot token for Telegram alerts
telegramChatIdstring—Chat ID for Telegram alerts
webhookUrlstring—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):

CodeCountry / Region
USDUnited States
EUREurozone (ECB)
GBPUnited Kingdom
JPYJapan
CADCanada
AUDAustralia
NZDNew Zealand
CHFSwitzerland
CNYChina

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


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:

FieldValue
ActorEconomic Calendar Tracker
Cron0 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:

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


Feedback

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