ForexFactory APIforexfactory.com ↗
Access ForexFactory economic calendar events, forex market quotes, news headlines, and forum data via 7 structured JSON endpoints. Filter by currency and impact level.
What is the ForexFactory API?
The ForexFactory API exposes 7 endpoints covering economic calendar events, real-time market quotes, news stories, and forum content from forexfactory.com. The get_calendar endpoint returns every scheduled event for a given week with fields including impact level, currency, and actual/forecast/previous values. get_calendar_filtered lets you narrow results by currency code and impact tier, with optional IANA timezone conversion for event times.
curl -X GET 'https://api.parse.bot/scraper/0d3aa2e2-80b6-42dc-986a-d7f0845f4deb/get_calendar?week=jun09.2026' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch economic calendar events for a specific week or the current week. Returns all scheduled events with date, time, currency, impact level, country, and actual/forecast/previous values. Events are grouped by day and include IDs usable with get_event_detail for historical data.
| Param | Type | Description |
|---|---|---|
| week | string | Week start date in 'monDD.YYYY' format (e.g. 'jun09.2026'). If omitted, returns current week's events. |
{
"type": "object",
"fields": {
"week": "string indicating the requested week identifier or 'current'",
"events": "array of economic calendar event objects with id, date, time, currency, impact, name, actual, forecast, previous, country"
},
"sample": {
"data": {
"week": "current",
"events": [
{
"id": 149579,
"date": "Sun Jun 7",
"name": "OPEC-JMMC Meetings",
"time": "All Day",
"actual": "",
"impact": "medium",
"country": "WW",
"currency": "All",
"forecast": "",
"previous": ""
},
{
"id": 148363,
"date": "Wed Jun 10",
"name": "Core CPI m/m",
"time": "7:30am",
"actual": "0.2%",
"impact": "high",
"country": "US",
"currency": "USD",
"forecast": "0.3%",
"previous": "0.4%"
}
]
},
"status": "success"
}
}About the ForexFactory API
Economic Calendar
The get_calendar endpoint accepts an optional week parameter in monDD.YYYY format (e.g. jun09.2026). Omit it to get the current week. Each event object includes id, date, time, currency, impact, name, actual, forecast, and previous. Event IDs can be passed directly to get_event_detail to retrieve the full release history for that indicator, including historical actual, forecast, and revision values alongside metadata like decimals and interval_name.
get_calendar_filtered adds four optional parameters: week, timezone (any valid IANA name such as America/New_York), currencies (comma-separated codes like USD,EUR,GBP), and impact_levels (comma-separated values from high, medium, low, holiday). The response includes a count field alongside the filtered events array and adds an event_time_utc field to each event.
Market Data and News
get_market_overview returns live data for eight major instruments: EUR/USD, GBP/USD, USD/JPY, USD/CHF, USD/CAD, AUD/USD, NZD/USD, and Gold/USD. Each instrument object contains price metrics across timeframes from M5 through D2 and bid/ask spread data from multiple quote sources. No parameters are required. get_news_latest returns the most recent stories from ForexFactory's news feed, each with a headline, url, impact, and preview field, ordered most-recent-first.
Forum Data
get_thread_posts fetches posts from any ForexFactory forum thread identified by a thread_id string (numeric ID plus URL slug, e.g. 1362090-gold-with-no-drama). Each post object includes post_id, author, date, content, and images. Pagination is supported via the page parameter. get_member_posts looks up all posts by a given username, returning 20 posts per page with total_pages and total_results counts. Each result includes thread_title, thread_link, content, and a has_image flag.
The ForexFactory API is a managed, monitored endpoint for forexfactory.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when forexfactory.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official forexfactory.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Alert trading systems when high-impact USD or EUR calendar events are released, using
get_calendar_filteredwithimpact_levels=high. - Build an economic calendar dashboard that displays real-time actual vs. forecast values from
get_calendarevent objects. - Pull historical release data for a specific indicator like Non-Farm Payrolls using
get_event_detailwith its event ID. - Monitor live EUR/USD and Gold/USD bid/ask spreads across timeframes via
get_market_overview. - Aggregate ForexFactory news headlines and impact ratings into a trading alert feed using
get_news_latest. - Archive and search forum thread discussions around a specific strategy using
get_thread_postswith pagination. - Audit posting history for a specific ForexFactory community member using
get_member_postswithtotal_resultsandtotal_pages.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ForexFactory offer an official developer API?+
What does `get_event_detail` return, and how do I get the right event ID?+
history object containing a meta block (with decimals and interval_name) and a data block listing all past releases for that indicator with actual, forecast, and revision values. Event IDs come from the id field on any event object returned by get_calendar or get_calendar_filtered.Can I get calendar events in my local timezone rather than the default server time?+
get_calendar_filtered. Pass any valid IANA timezone name (e.g. Europe/Berlin, Asia/Tokyo) as the timezone parameter. The time field will be converted accordingly, and an additional event_time_utc field is included in each event. The base get_calendar endpoint does not perform timezone conversion.Does the API cover ForexFactory's trade explorer, broker listings, or premium member features?+
How far back does the historical event data go in `get_event_detail`?+
interval_name field in the meta block indicates the release cadence (e.g. monthly, weekly).