Forex Factory Calendar Scraper - Economic Events & Forecasts
Pricing
$0.36 / 1,000 calendar events
Forex Factory Calendar Scraper - Economic Events & Forecasts
Scrape the Forex Factory economic calendar for this week: every event with UTC and local time, currency, country, impact, type, forecast, previous and parsed numbers. Plus Metals Mine, Energy EXCH and Crypto Craft calendars, filters, news window and monitor mode. $0.36 per 1,000 events.
Pricing
$0.36 / 1,000 calendar events
Rating
0.0
(0)
Developer
Top Api
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
5 days ago
Last modified
Categories
Features
Share
Scrape the Forex Factory economic calendar for the current week: every event (CPI, Non-Farm Payrolls, rate decisions, PMIs, GDP, speeches, bond auctions, holidays) with its release time in UTC and in your time zone, currency, country, impact (High / Medium / Low / Holiday), event type, consensus forecast and previous value, the numbers parsed (0.2% -> 0.2, unit %), the direction the forecast expects against the previous release, minutes until the release and the event's Forex Factory link. The same for Forex Factory's sister calendars Metals Mine, Energy EXCH and Crypto Craft, which rate impact for their own markets. Filters, a news window for trading bots, monitor mode and webhooks. No login, no browser, no API key.
What you get
| What you choose | Example | What you get |
|---|---|---|
| Forex Factory, this week | the prefilled input | Every event of the week, Sunday to Saturday (105 events in the week of 2026-11-08) |
| A period | today, tomorrow, todayAndTomorrow, upcoming, custom dates, or hoursAhead: 24 | Only those days or hours, counted in your time zone |
| Filters | High impact, USD + EUR, inflation and employment, title contains CPI | Only the events you trade |
| Other calendars | metalsmine, energyexch, cryptocraft | The same events rated for metals, energy or crypto (crude oil inventories: Low on Forex Factory, High on Energy EXCH) |
| Monitor mode | scheduled hourly | Only events that are new or whose time, impact, forecast or previous changed since the last run |
Quick input
{"calendars": ["forexfactory"],"period": "thisWeek","timezone": "UTC"}
This is the prefilled input: the whole week on Forex Factory in about one second. With no input at all, the same runs.
More examples:
{ "impacts": ["High"], "currencies": ["USD", "EUR", "GBP"], "period": "upcoming", "timezone": "America/New_York" }
{ "keywords": ["CPI", "Non-Farm", "Rate"], "onlyWithForecast": true, "sortBy": "impact" }
{ "impacts": ["High"], "hoursAhead": 24, "newsWindowMinutes": 30, "timezone": "Europe/London" }
{ "calendars": ["forexfactory", "energyexch", "metalsmine", "cryptocraft"], "impacts": ["High", "Medium"] }
{ "monitorMode": true, "impacts": ["High", "Medium"], "webhookUrl": "https://example.com/hook" }
Input
| Field | What it does | Default |
|---|---|---|
calendars | forexfactory, metalsmine, energyexch, cryptocraft. One row per event per calendar. | ["forexfactory"] |
period | thisWeek, today, tomorrow, yesterday, todayAndTomorrow, upcoming (still ahead), custom (uses dateFrom / dateTo). Days are counted in timezone. | thisWeek |
dateFrom, dateTo | Custom period, YYYY-MM-DD, inclusive, inside the current week. Setting a date switches the period to custom. | - |
hoursAhead | Only events releasing within the next N hours. | - |
timezone | IANA name (America/New_York, Europe/London, Asia/Tokyo ...) for date, time and localDateTime. dateTimeUtc is always UTC. | UTC |
impacts | Any of High, Medium, Low, Holiday. minImpact (high / medium / low) works too. | all |
currencies | USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, CNY, All (global events), and MXN, RUB, INR, ZAR, BRL on the sister calendars. | all |
categories | growth, inflation, employment, centralBank, bonds, housing, consumerSurveys, businessSurveys, speeches, misc. | all |
keywords | Keep events whose title, currency or country contains one of these (case-insensitive). | - |
excludeKeywords | Drop events whose title contains one of these, e.g. Speaks, Auction. | - |
eventStatus | all, upcoming (release time still ahead), passed. upcomingOnly: true and onlyReleased: true work too. | all |
onlyWithForecast | Keep only events that publish a consensus forecast. | false |
newsWindowMinutes | inNewsWindow is true for events within this many minutes of the run, before or after. | 30 |
onlyInNewsWindow | Keep only events inside the news window ("is high-impact news due now?" with impacts: ["High"]). | false |
sortBy | time, impact (High first), currency. | time |
maxItems | Most rows for the run (0 = no limit). | 1000 |
monitorMode | Deliver only new events and events that changed since the last run. | false |
monitorKey | Name of the monitor's memory; use different names for separate watches. | ff-calendar |
resetMonitor | Forget what earlier runs delivered. | false |
webhookUrl | POST a JSON summary of the delivered events (up to 200) after the run writes them. Not called when nothing is delivered. | - |
proxyConfiguration | Not needed. Used only if the direct request is refused (then Apify residential). | none |
Every filter runs before anything is charged. Field names from other Forex Factory actors are accepted too (dateRange, startDate, endDate, impactLevels, minImpact, eventKeywords, upcomingOnly, onlyReleased, changesOnly, maxResults, max_items).
Output
One row per calendar event. A real row from a run on 2026-11-13 (impacts: ["High","Medium"], timezone: America/New_York):
{"eventId": "79-20261110","calendar": "forexfactory","calendarName": "Forex Factory","title": "Core CPI m/m","currency": "USD","country": "United States","countryCode": "US","ffCountryCode": "us","impact": "High","impactLevel": 3,"category": "inflation","dateTimeUtc": "2026-11-10T13:30:00.000Z","timestamp": 1794317400,"date": "2026-11-10","time": "08:30","dayOfWeek": "Tuesday","localDateTime": "2026-11-10T08:30:00-05:00","timezone": "America/New_York","utcOffset": "-05:00","allDay": false,"forecast": "0.2%","previous": "0.3%","forecastValue": 0.2,"previousValue": 0.3,"unit": "%","forecastVsPrevious": "lower","forecastChange": -0.1,"hasForecast": true,"status": "passed","minutesUntil": -4597,"inNewsWindow": false,"url": "https://www.forexfactory.com/calendar/79-us-core-cpi-mm","seriesId": 79,"seriesSlug": "us-core-cpi-mm","source": "https://nfs.faireconomy.media/ff_calendar_thisweek.csv","scrapedAt": "2026-11-13T18:06:38.296Z"}
| Field | Meaning |
|---|---|
eventId | Forex Factory series id + UTC day. Stable across runs; the same event has the same id on all four calendars. |
calendar, calendarName | Which calendar the row comes from. |
title | Event title as Forex Factory shows it. |
currency | The currency the event moves (All = global events such as G7 or OPEC meetings). |
country, countryCode, ffCountryCode | Country of the release, from Forex Factory's own series code (ge = Germany for a EUR event). |
impact, impactLevel | Expected impact (High 3, Medium 2, Low 1, Holiday 0) as rated by that calendar. |
category | Event type, classified from the title. |
dateTimeUtc, timestamp | Release time in UTC (ISO) and as Unix seconds. |
date, time, dayOfWeek, localDateTime, timezone, utcOffset | Release time in your time zone. |
allDay | True when the calendar gives a day but no time. |
forecast, previous | As shown on the calendar. |
forecastValue, previousValue, unit | The same as numbers (19.2B -> 19.2, unit B). Bond auctions show "yield|bid-to-cover" and stay text. |
forecastVsPrevious, forecastChange | higher / lower / same, and the difference. |
hasForecast | A consensus forecast is published. |
status, minutesUntil, inNewsWindow | Upcoming or passed at run time, minutes to the release, inside the news window. |
url, seriesId, seriesSlug | The event's page on the calendar's site (history, specs, source). |
changeType, changedFields, previousValues, firstSeenAt | Monitor mode only. |
source, scrapedAt | The calendar file read and when. |
Released actual values and past or next weeks are not in this actor: Forex Factory shows them only on its calendar pages, which answer automated requests with a Cloudflare challenge.
Fields and how often they are filled
Measured on the Forex Factory week of 2026-11-08 to 2026-11-14 (105 events):
| Field | Filled |
|---|---|
| eventId, title, currency, country, impact, category, dateTimeUtc, date, time, url, seriesId, status, minutesUntil | 100% |
| countryCode, ffCountryCode | 98% (global events have none) |
| previous | 60% |
| previousValue | 55% (bond auctions show "yield|bid-to-cover", kept as text) |
| forecast, forecastValue, forecastVsPrevious | 46% (speeches, meetings and holidays have none) |
Impact in that week: 5 High, 6 Medium, 91 Low, 3 Holiday. Metals Mine had 69 events, Energy EXCH 44, Crypto Craft 15.
Monitor mode
Turn on monitorMode and schedule the actor (hourly is plenty: Forex Factory updates the calendar file about once an hour). The first run delivers every matching event (changeType: "new"). Every later run delivers only:
- events not delivered before (
changeType: "new"), and - events whose time, impact, title, forecast or previous changed (
changeType: "changed", withchangedFieldsand the old values inpreviousValues).
A run with nothing new delivers nothing and charges nothing. The memory is kept per monitorKey and calendar set; resetMonitor: true starts over. With webhookUrl, each run that delivers something POSTs a summary:
{ "actor": "forexfactory-scraper", "runId": "...", "calendars": ["forexfactory"], "delivered": 2, "newEvents": 1, "changedEvents": 1, "datasetId": "...", "items": [{ "eventId": "78-20261110", "title": "CPI m/m", "currency": "USD", "impact": "High", "dateTimeUtc": "2026-11-10T13:30:00.000Z", "forecast": "0.3%", "previous": "0.6%", "changeType": "changed", "changedFields": ["forecast"], "url": "https://www.forexfactory.com/calendar/78-us-cpi-mm" }] }
Pricing
$0.36 per 1,000 events ($0.00036 per delivered row). No start fee. Rows removed by a filter, rows over maxItems and unchanged rows in monitor mode are not charged. A full Forex Factory week (about 100 events) costs about $0.04.
Speed and limits
- A run reads one small file per calendar (2-13 KB) and takes 1-2 seconds (measured on 120+ runs on 2026-11-13).
- The calendar covers the current week only (Sunday to Saturday, US Eastern), as Forex Factory publishes it.
- Forex Factory allows a few downloads of the calendar file per IP address in five minutes. If the direct download is refused, the run retries through Apify's proxies once per rung; if every rung is refused, the run fails without charging and says so.
categoryis our classification from the title; it is not a Forex Factory field.