forexfactory.com APIforexfactory.com ↗
Access ForexFactory economic calendar events, market quotes for 8 major pairs, news headlines, and forum posts via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/0d3aa2e2-80b6-42dc-986a-d7f0845f4deb/get_calendar' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch economic calendar events for a specific week or the current week. Returns all events with their date, time, currency, impact level, and actual/forecast/previous values.
| Param | Type | Description |
|---|---|---|
| week | string | Week start date in 'monDD.YYYY' format (e.g. 'feb15.2026'). If omitted, returns current week's events. |
{
"type": "object",
"fields": {
"week": "string indicating the requested week or 'current'",
"events": "array of economic calendar event objects"
},
"sample": {
"data": {
"week": "current",
"events": [
{
"id": 150183,
"date": "Sun May 10",
"name": "CPI y/y",
"time": "8:30pm",
"actual": "1.2%",
"impact": "medium",
"country": "CH",
"currency": "CNY",
"forecast": "0.9%",
"previous": "1.0%"
}
]
},
"status": "success"
}
}About the forexfactory.com API
This API exposes 6 endpoints covering ForexFactory's economic calendar, market quotes, news feed, and forum content. The get_calendar endpoint returns every scheduled event for a given week with date, time, currency, impact level, and actual/forecast/previous values. Filtering by currency pair or impact level, fetching historical release data for a specific event, and reading forum thread posts are all supported in a single integration.
Economic Calendar
The get_calendar endpoint returns all events for the current week or any specified week using the week parameter (formatted as monDD.YYYY, e.g. feb15.2026). Each event object includes the event date, time, currency code, impact level, and the actual, forecast, and previous numeric values where available. For tighter control, get_calendar_filtered accepts comma-separated currencies (e.g. USD,EUR,GBP) and impact_levels (e.g. high,medium) parameters and returns a filtered array along with a count of matching events.
Event History and Market Data
get_event_detail accepts a numeric event_id (obtainable from events[*].id in calendar responses) and returns the full historical release series for that event, including a meta object with decimals and interval_name and a data array of past releases with actual, forecast, and revision figures. The get_market_overview endpoint requires no inputs and returns an array of instrument objects covering EUR/USD, GBP/USD, USD/JPY, USD/CHF, USD/CAD, AUD/USD, NZD/USD, and Gold/USD, each with multi-timeframe metrics and quotes from multiple data sources.
News and Forum
get_news_latest returns the current ForexFactory news feed as a stories array where each entry includes a headline, url, impact classification, and a short preview text. get_thread_posts retrieves posts from a named forum thread using a thread_id in the format threadNumber-slug (e.g. 1362090-gold-with-no-drama). Responses include post_id, author, date, content, and any embedded images. An optional page integer parameter handles pagination for long threads.
- Alert trading systems when high-impact USD or EUR calendar events are released using get_calendar_filtered with impact_levels=high
- Track historical forecast vs. actual divergence for recurring events like Non-Farm Payrolls using get_event_detail
- Build a forex dashboard displaying live quotes for the 8 major currency pairs from get_market_overview
- Aggregate and categorize breaking forex news headlines and their impact ratings from get_news_latest
- Archive forum discussion threads on specific trading strategies by paginating through get_thread_posts
- Filter the economic calendar to only show events for a single currency (e.g. JPY) using the currencies parameter in get_calendar_filtered
- Correlate news impact levels from get_news_latest with same-day calendar events from get_calendar for event-driven analysis
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.