Forex News Filter & Economic Calendar for Trading Bots

One run returns this week's economic calendar for the nine major currencies (USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, CNY) with impact rating, forecast and previous value, and answers the question a trading bot asks before every order: is a high-impact release within N minutes of now for my currency? No API keys, no login.

Most strategies stand aside around CPI, payrolls and central bank decisions. This Actor is the plumbing for that rule: a news filter for bots and expert advisors, an alert feed for the week's big releases, and a calendar source for dashboards and AI agents. Times are UTC, field names are stable, and every row carries minutesUntil and inNewsWindow so one API call is enough.

What you get

One row per scheduled event, oldest first.

Field	Example
time	2026-11-13T13:30:00.000Z (UTC)
currency	USD; ALL for events that concern every currency
title	Core PPI m/m
impact	high, medium, low or holiday
forecast, previous	0.3%, 0.7%; null when the event has none (speeches, holidays)
status	upcoming or passed
minutesUntil	3132; negative once the event has passed
inNewsWindow	true when the event is high impact and within newsWindowMinutes of now, before or after
id, snapshotTime	A stable id per event and when the run looked

The key-value store record SUMMARY holds the news filter:

Field	Meaning
newsFilter.<currency>.inNewsWindow	true when a high-impact event for that currency is inside the window
newsFilter.<currency>.nextHighImpact, lastHighImpact	Title, time and minutesUntil of the nearest high-impact event ahead and behind
currenciesInNewsWindow	For example ["USD"]
nextHighImpact	The next high-impact event across your currencies
feedFetchedAt	When the calendar was last fetched from the source

Input

Field	Default	Notes
currencies	all nine	Any subset. Events marked ALL are always included
minImpact	medium	low returns everything, high only the market movers
includeHolidays	true	Bank holidays, returned with impact holiday
upcomingOnly	false	Drop events that already passed, except those still inside the news window
newsWindowMinutes	30	Minutes before and after a high-impact event, 1 to 1440

Typical uses

• Bot news filter: before trading EURUSD, run with currencies: ["EUR", "USD"], minImpact: "high", upcomingOnly: true and skip the trade when any row has inNewsWindow: true. Schedule every 5 to 15 minutes, or call it on demand.
• Weekly briefing: run on Monday with minImpact: "medium" and send the dataset to Slack, Telegram or email with an Apify integration.
• Agents: call it from an AI agent or MCP client to ask what is on the calendar today.

Notes and limits

• The data is ForexFactory's public weekly calendar export, including its impact ratings. This Actor is not affiliated with ForexFactory.
• The calendar covers the current week, Sunday to Saturday. There is no next-week look-ahead, so late on Friday and on Saturday nothing is upcoming until the new week is published.
• It is a schedule: forecast and previous values, no actual results.
• The calendar is fetched at most once every 5 minutes per account and kept in the key-value store forex-news-filter-cache. If the source is unreachable, a copy up to 12 hours old is used and feedFetchedAt shows its age; without one the run fails rather than return nothing.
• Schedules change. A release can be moved or added during the week, so poll again close to the time that matters.
• Data only, not financial advice.

Cost

Pay per event, no subscription. You pay only for the events a run returns.

Event	Price
Run start, once per run	$0.002
Calendar event row	$0.001

A full week at every impact level is about 100 rows and costs about 10 cents. A bot check with two currencies, minImpact: "high" and upcomingOnly: true returns a handful of rows and costs about 1 cent.

Run it from code

curl -X POST "https://api.apify.com/v2/acts/cryptoretirement~forex-news-filter-economic-calendar/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"currencies":["EUR","USD"],"minImpact":"high","upcomingOnly":true,"newsWindowMinutes":30}'

The response is the dataset as a JSON array. The API menu on this page has ready-made snippets for JavaScript, Python and MCP clients.

More Actors for traders and bots

• Crypto Signal Scanner: Donchian breakouts, golden and death crosses and Supertrend flips on the top Bybit perpetuals.
• Crypto Session Box Levels & Liquidity Sweep Detector: prior-day and session boxes, wick setups and liquidity sweeps.
• Crypto Perp Funding Rate Scanner: funding rates, annualised yield and cross-exchange spreads on 5 exchanges.
• Crypto Exchange New Listing Announcements: new coin and perpetual listings from 6 exchanges, with an alert flag.
• Solana Token Rug Check + Coin Score: rug gates, a honeypot sell test and a 0-100 score for any Solana token.
• DEX Pool Health Score: health and rug-risk score for any liquidity pool on 100+ networks.
• YouTube Most Replayed Clip Finder: the most replayed moments of any video as ready-to-cut clips.