Forex Factory Economic Calendar Scraper
Pricing
from $1.50 / 1,000 calendar events
Forex Factory Economic Calendar Scraper
Pricing
from $1.50 / 1,000 calendar events
Which days to scrape, counted in the timezone you pick below. Weeks run Sunday to Saturday like the Forex Factory week view (switch to Monday below). Choose "Custom" to set exact dates.
First day for the "Custom dates" range, YYYY-MM-DD. History goes back to 2007-01-01; long ranges are split automatically.
Last day (inclusive) for the "Custom dates" range, YYYY-MM-DD. Leave empty for a single day.
IANA timezone for every date and time in the output and for the date range, e.g. "UTC", "America/New_York", "Europe/London", "Europe/Warsaw", "Asia/Tokyo", "Australia/Sydney". UTC times are always included too.
First day of the week for "This / Next / Last week".
Only events for these currencies. Leave empty for all. "All" = global events such as IMF or OPEC meetings.
Only events with these expected impact levels. Leave empty for all.
Only these event categories (Forex Factory's own classification). Leave empty for all. Every event carries its category either way.
Only events whose title contains any of these words (case-insensitive), e.g. "CPI", "Non-Farm", "PMI", "Rate", "Lagarde".
Drop events whose title contains any of these words, e.g. "Bond Auction", "Speaks".
Keep only events whose actual figure is already published.
Add each event's specs (source, what it measures, usual effect, frequency, next release, notes, why traders care) and its past releases. One extra request per event.
How many past releases to add per event when details are on. 5 comes with the details; more (e.g. 24, 120) reads the full series, back to 2000 for major indicators. 0 = none, -1 = everything.
Remember figures between runs and output only what moved. Schedule the actor every few minutes to get a "just released" feed of actuals.
"Released actuals" outputs only events whose actual is new or changed since the last run (the first run outputs the actuals already out). "All changes" also reports new events, forecast revisions and reschedules.
Output every event, each tagged NEW / UPDATED / UNCHANGED.
Name of the memory used to compare runs. Runs with the same name share it. Leave empty to derive it from your filters.
POST a JSON alert (message + events) here whenever there is something to output.
Bot token from @BotFather, to get alerts in Telegram.
How many events to list in one alert message.
Optional: paste calendar links instead of a date range, e.g. https://www.forexfactory.com/calendar?week=next, ?day=oct2.2026, ?month=last, ?range=oct1.2026-oct31.2026. A link with #detail=… returns just that event. Filters above still apply.
Stop after this many events. 0 = no limit.
How many requests run at once.
