---
type: "firecrawl-provider"
description: "Forex Factory's economic calendar (www.forexfactory.com/calendar): scheduled releases by day, week, month or custom range with impact, currency and event-type filters; per-event details, release history, numeric history series and indicator name search. Public, anonymous, read-only."
use_when: "Forex Factory's economic calendar (www.forexfactory.com/calendar): scheduled releases by day, week, month or custom range with impact, currency and event-type filters; per-event details, release history, numeric history series and indicator name search. Public, anonymous, read-only."
categories: "Finance"
capabilities: 5
credits_per_call: 5
---
# Forex Factory economic calendar on Firecrawl Alexandria
Forex Factory's economic calendar (www.forexfactory.com/calendar): scheduled releases by day, week, month or custom range with impact, currency and event-type filters; per-event details, release history, numeric history series and indicator name search. Public, anonymous, read-only.
- Categories: Finance
- Category index: [Finance category](https://firecrawl.dev/alexandria/agents/categories/finance)
- Provider key: `forexfactory-com`
- Access: Firecrawl credits
- Cost: 5 credits per call
## More
- [Human guide](https://firecrawl.dev/app/alexandria/forexfactory-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/openapi.json)
## Capabilities
- [Event detail](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/event_detail): Details of one calendar release: the site's spec rows (Source, Measures, Usual Effect, Frequency, Next Release, FF Notes, Why Traders Care, Acro Expand) and the first page of the indicator's release history with actual, forecast, previous and revision values.
- [Event graph](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/event_graph): Numeric history series of an indicator (the data behind the site's event chart): per release the actual, forecast and revision as numbers and as formatted strings, the period label and epoch time, oldest first.
- [Event history](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/event_history): An indicator's release history (newest first) keyed by any of its release event ids: date, actual, forecast, previous, revision and the site's better/worse judgement. `depth` is the site's Show More step and is cumulative: each step returns a longer prefix of the same history (observed 15 rows at depth 1, 35 at 2, 65 at 3), so one call at the returned continuation depth supersedes the previous one; `has_more` says whether a deeper step exists.
- [List events](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/list_events): List the economic calendar events of one day, week, month or custom date range (at most 62 days), optionally filtered by impact, currency and event type. Returns each event's identifiers, scheduled time (epoch seconds and UTC), impact, actual, forecast, previous and revision values as the site states them (empty values are null). Parsed from the calendar page's inline state (same data the site's calendar app renders).
- [Search events](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/search_events): Search calendar indicators by name (the calendar's autocomplete). Returns matching indicator series with their ebase_id, slug, impact and solo page URL.
## 1. Choose this provider when
Forex Factory's economic calendar (www.forexfactory.com/calendar): scheduled releases by day, week, month or custom range with impact, currency and event-type filters; per-event details, release history, numeric history series and indicator name search. Public, anonymous, read-only.
## 2. Minimal request
Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.
```json
{
"provider": "forexfactory-com",
"capability": "economic-calendar/event_detail",
"options": {
"event_id": 148235
}
}
```
## 3. Add provider options
Use only the options needed for the task:
- `event_id` (number, required): Per-release event id from list_events (e.g. 148235). Example: `10`
## 4. Request through your preferred interface
### JavaScript
```javascript
const result = await firecrawl.scrape({
alexandria: {
provider: "forexfactory-com",
capability: "economic-calendar/event_detail",
options: {
event_id: 148235,
},
},
});
```
### Python
```python
result = firecrawl.scrape_alexandria({
"provider": "forexfactory-com",
"capability": "economic-calendar/event_detail",
"options": {
"event_id": 148235
}
})
```
### cURL
```sh
curl https://api.firecrawl.dev/v2/scrape \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"alexandria": {
"provider": "forexfactory-com",
"capability": "economic-calendar/event_detail",
"options": {
"event_id": 148235
}
}
}'
```
### CLI
```sh
firecrawl scrape 'forexfactory-com/economic-calendar/event_detail' \
--options '{"event_id":148235}'
```
### MCP
Call the FCX MCP retrieve tool with this object:
```json
{
"provider": "forexfactory-com",
"capability": "economic-calendar/event_detail",
"options": {
"event_id": 148235
}
}
```
Ask for only the returned fields needed by the task.
## 5. Full request shape
```json
{
"provider": "forexfactory-com",
"capability": "economic-calendar/event_detail",
"options": {
"event_id": 148235
}
}
```
## 6. Response data
The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:
```json
{
"event_id": 148235,
"history": {
"events": [
{
"actual": "0.2%",
"actual_better_worse": null,
"date": "Aug 26, 2026",
"event_id": 148234,
"forecast": "0.2%",
"impact": "high",
"previous": "0.1%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=aug26.2026#detail=148234"
},
{
"actual": "0.1%",
"actual_better_worse": "worse",
"date": "Jul 30, 2026",
"event_id": 148233,
"forecast": "0.2%",
"impact": "high",
"previous": "0.3%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=jul30.2026#detail=148233"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Jun 25, 2026",
"event_id": 148232,
"forecast": "0.3%",
"impact": "high",
"previous": "0.2%",
"revision": "0.3%",
"revision_better_worse": "better",
"url": "https://www.forexfactory.com/calendar?day=jun25.2026#detail=148232"
},
{
"actual": "0.2%",
"actual_better_worse": "worse",
"date": "May 28, 2026",
"event_id": 148231,
"forecast": "0.3%",
"impact": "high",
"previous": "0.3%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=may28.2026#detail=148231"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Apr 30, 2026",
"event_id": 148230,
"forecast": "0.3%",
"impact": "high",
"previous": "0.4%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=apr30.2026#detail=148230"
}
],
"has_data_values": true,
"has_more": true
},
"linked_thread_count": 0,
"next_release": {
"date": "Oct 29, 2026",
"event_id": 148236
},
"observed_at_ms": 1791018179422,
"source_url": "https://www.forexfactory.com/calendar/details/1-148235",
"specs": [
{
"html": "Bureau of Economic Analysis (latest release)",
"text": "Bureau of Economic Analysis (latest release)",
"title": "Source"
},
{
"html": "Change in the price of goods and services purchased by consumers, excluding food and energy;",
"text": "Change in the price of goods and services purchased by consumers, excluding food and energy;",
"title": "Measures"
},
{
"html": "'Actual' greater than 'Forecast' is good for currency;",
"text": "'Actual' greater than 'Forecast' is good for currency;",
"title": "Usual Effect"
},
{
"html": "Released monthly, about 29 days after the month ends;",
"text": "Released monthly, about 29 days after the month ends;",
"title": "Frequency"
},
{
"html": "Oct 29, 2026",
"text": "Oct 29, 2026",
"title": "Next Release"
},
{
"html": "Differs from Core CPI in that it only measures goods and services targeted towards and consumed by individuals. Prices are weighted according to total expenditure per item which gives important insights into consumer spending behavior. CPI is released about 10 days earlier and tends to garner most of the attention;",
"text": "Differs from Core CPI in that it only measures goods and services targeted towards and consumed by individuals. Prices are weighted according to total expenditure per item which gives important insights into consumer spending behavior. CPI is released about 10 days earlier and tends to garner most of the attention;",
"title": "FF Notes"
},
{
"html": "It's the Federal Reserve's primary inflation measure. Inflation is important to currency valuation because rising prices lead the central bank to raise interest rates out of respect for their inflation containment mandate;",
"text": "It's the Federal Reserve's primary inflation measure. Inflation is important to currency valuation because rising prices lead the central bank to raise interest rates out of respect for their inflation containment mandate;",
"title": "Why Traders Care"
},
{
"html": "Personal Consumption Expenditures (PCE), Consumer Price Index (CPI);",
"text": "Personal Consumption Expenditures (PCE), Consumer Price Index (CPI);",
"title": "Acro Expand"
}
]
}
```
## API reference-derived contract
The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.
### Event detail
- Capability: `economic-calendar/event_detail`
- Description: Details of one calendar release: the site's spec rows (Source, Measures, Usual Effect, Frequency, Next Release, FF Notes, Why Traders Care, Acro Expand) and the first page of the indicator's release history with actual, forecast, previous and revision values.
- Instructions: After list_events gave an event_id; for the full history use event_history (paged) or event_graph (numeric series).
- Cost: 5 credits per call
- Capability file: [Event detail](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/event_detail)
Accepted options:
- `event_id` (number, required): Per-release event id from list_events (e.g. 148235). Example: `10`
Response schema example:
```json
{
"event_id": 148235,
"history": {
"events": [
{
"actual": "0.2%",
"actual_better_worse": null,
"date": "Aug 26, 2026",
"event_id": 148234,
"forecast": "0.2%",
"impact": "high",
"previous": "0.1%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=aug26.2026#detail=148234"
},
{
"actual": "0.1%",
"actual_better_worse": "worse",
"date": "Jul 30, 2026",
"event_id": 148233,
"forecast": "0.2%",
"impact": "high",
"previous": "0.3%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=jul30.2026#detail=148233"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Jun 25, 2026",
"event_id": 148232,
"forecast": "0.3%",
"impact": "high",
"previous": "0.2%",
"revision": "0.3%",
"revision_better_worse": "better",
"url": "https://www.forexfactory.com/calendar?day=jun25.2026#detail=148232"
},
{
"actual": "0.2%",
"actual_better_worse": "worse",
"date": "May 28, 2026",
"event_id": 148231,
"forecast": "0.3%",
"impact": "high",
"previous": "0.3%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=may28.2026#detail=148231"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Apr 30, 2026",
"event_id": 148230,
"forecast": "0.3%",
"impact": "high",
"previous": "0.4%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=apr30.2026#detail=148230"
}
],
"has_data_values": true,
"has_more": true
},
"linked_thread_count": 0,
"next_release": {
"date": "Oct 29, 2026",
"event_id": 148236
},
"observed_at_ms": 1791018179422,
"source_url": "https://www.forexfactory.com/calendar/details/1-148235",
"specs": [
{
"html": "Bureau of Economic Analysis (latest release)",
"text": "Bureau of Economic Analysis (latest release)",
"title": "Source"
},
{
"html": "Change in the price of goods and services purchased by consumers, excluding food and energy;",
"text": "Change in the price of goods and services purchased by consumers, excluding food and energy;",
"title": "Measures"
},
{
"html": "'Actual' greater than 'Forecast' is good for currency;",
"text": "'Actual' greater than 'Forecast' is good for currency;",
"title": "Usual Effect"
},
{
"html": "Released monthly, about 29 days after the month ends;",
"text": "Released monthly, about 29 days after the month ends;",
"title": "Frequency"
},
{
"html": "Oct 29, 2026",
"text": "Oct 29, 2026",
"title": "Next Release"
},
{
"html": "Differs from Core CPI in that it only measures goods and services targeted towards and consumed by individuals. Prices are weighted according to total expenditure per item which gives important insights into consumer spending behavior. CPI is released about 10 days earlier and tends to garner most of the attention;",
"text": "Differs from Core CPI in that it only measures goods and services targeted towards and consumed by individuals. Prices are weighted according to total expenditure per item which gives important insights into consumer spending behavior. CPI is released about 10 days earlier and tends to garner most of the attention;",
"title": "FF Notes"
},
{
"html": "It's the Federal Reserve's primary inflation measure. Inflation is important to currency valuation because rising prices lead the central bank to raise interest rates out of respect for their inflation containment mandate;",
"text": "It's the Federal Reserve's primary inflation measure. Inflation is important to currency valuation because rising prices lead the central bank to raise interest rates out of respect for their inflation containment mandate;",
"title": "Why Traders Care"
},
{
"html": "Personal Consumption Expenditures (PCE), Consumer Price Index (CPI);",
"text": "Personal Consumption Expenditures (PCE), Consumer Price Index (CPI);",
"title": "Acro Expand"
}
]
}
```
### Event graph
- Capability: `economic-calendar/event_graph`
- Description: Numeric history series of an indicator (the data behind the site's event chart): per release the actual, forecast and revision as numbers and as formatted strings, the period label and epoch time, oldest first.
- Instructions: For charting or computing over an indicator's history; event_history gives the same releases as paged strings with links.
- Cost: 5 credits per call
- Capability file: [Event graph](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/event_graph)
Accepted options:
- `event_id` (number, required): Any release event id of the indicator (from list_events). Example: `10`
- `limit` (number): Most recent points to return (the site's chart asks for 100). Example: `100`
Response schema example:
```json
{
"decimals": 1,
"ebase_id": 85,
"event_id": 148235,
"interval": "MN1",
"is_more": true,
"observed_at_ms": 1791018197549,
"point_count": 12,
"points": [
{
"actual": 0.2,
"actual_formatted": "0.2%",
"dateline": 1764946800,
"datetime_utc": "2025-12-05T15:00:00Z",
"event_id": 150985,
"forecast": 0.2,
"forecast_formatted": "0.2%",
"is_most_recent": false,
"period": "Dec 2025",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.2,
"actual_formatted": "0.2%",
"dateline": 1769093940,
"datetime_utc": "2026-01-22T14:59:00Z",
"event_id": 152037,
"forecast": null,
"forecast_formatted": null,
"is_most_recent": false,
"period": "Jan 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.2,
"actual_formatted": "0.2%",
"dateline": 1769094000,
"datetime_utc": "2026-01-22T15:00:00Z",
"event_id": 148227,
"forecast": 0.2,
"forecast_formatted": "0.2%",
"is_most_recent": false,
"period": "Jan 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.4,
"actual_formatted": "0.4%",
"dateline": 1771594200,
"datetime_utc": "2026-02-20T13:30:00Z",
"event_id": 152042,
"forecast": 0.3,
"forecast_formatted": "0.3%",
"is_most_recent": false,
"period": "Feb 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.4,
"actual_formatted": "0.4%",
"dateline": 1773405000,
"datetime_utc": "2026-03-13T12:30:00Z",
"event_id": 152086,
"forecast": 0.4,
"forecast_formatted": "0.4%",
"is_most_recent": false,
"period": "Mar 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.4,
"actual_formatted": "0.4%",
"dateline": 1775737800,
"datetime_utc": "2026-04-09T12:30:00Z",
"event_id": 148229,
"forecast": 0.4,
"forecast_formatted": "0.4%",
"is_most_recent": false,
"period": "Apr 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.3,
"actual_formatted": "0.3%",
"dateline": 1777552200,
"datetime_utc": "2026-04-30T12:30:00Z",
"event_id": 148230,
"forecast": 0.3,
"forecast_formatted": "0.3%",
"is_most_recent": false,
"period": "Apr 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.2,
"actual_formatted": "0.2%",
"dateline": 1779971400,
"datetime_utc": "2026-05-28T12:30:00Z",
"event_id": 148231,
"forecast": 0.3,
"forecast_formatted": "0.3%",
"is_most_recent": false,
"period": "May 2026",
"revision": 0.3,
"revision_formatted": "0.3%"
},
{
"actual": 0.3,
"actual_formatted": "0.3%",
"dateline": 1782390600,
"datetime_utc": "2026-06-25T12:30:00Z",
"event_id": 148232,
"forecast": 0.3,
"forecast_formatted": "0.3%",
"is_most_recent": false,
"period": "Jun 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.1,
"actual_formatted": "0.1%",
"dateline": 1785414600,
"datetime_utc": "2026-07-30T12:30:00Z",
"event_id": 148233,
"forecast": 0.2,
"forecast_formatted": "0.2%",
"is_most_recent": false,
"period": "Jul 2026",
"revision": null,
"revision_formatted": null
},
{
"actual": 0.2,
"actual_formatted": "0.2%",
"dateline": 1787747400,
"datetime_utc": "2026-08-26T12:30:00Z",
"event_id": 148234,
"forecast": 0.2,
"forecast_formatted": "0.2%",
"is_most_recent": false,
"period": "Aug 2026",
"revision": 0.1,
"revision_formatted": "0.1%"
},
{
"actual": 0.2,
"actual_formatted": "0.2%",
"dateline": 1790771400,
"datetime_utc": "2026-09-30T12:30:00Z",
"event_id": 148235,
"forecast": 0.3,
"forecast_formatted": "0.3%",
"is_most_recent": true,
"period": "Sep 2026",
"revision": null,
"revision_formatted": null
}
],
"source_url": "https://www.forexfactory.com/calendar/graph/148235?limit=12&site_id=1"
}
```
### Event history
- Capability: `economic-calendar/event_history`
- Description: An indicator's release history (newest first) keyed by any of its release event ids: date, actual, forecast, previous, revision and the site's better/worse judgement. `depth` is the site's Show More step and is cumulative: each step returns a longer prefix of the same history (observed 15 rows at depth 1, 35 at 2, 65 at 3), so one call at the returned continuation depth supersedes the previous one; `has_more` says whether a deeper step exists.
- Instructions: To read an indicator's release history further back than the five rows event_detail returns; event_graph gives the same values as numbers for charting.
- Cost: 5 credits per call
- Capability file: [Event history](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/event_history)
Accepted options:
- `depth` (number): Show More step, cumulative: depth 1 is the first expansion (about 15 newest releases), each further step returns a longer prefix. Pass the continuation cursor to go deeper. Example: `1`
- `event_id` (number, required): Any release event id of the indicator (from list_events). Example: `10`
Response schema example:
```json
{
"depth": 1,
"event_count": 15,
"event_id": 148235,
"events": [
{
"actual": "0.2%",
"actual_better_worse": null,
"date": "Aug 26, 2026",
"event_id": 148234,
"forecast": "0.2%",
"impact": "high",
"previous": "0.1%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=aug26.2026#detail=148234"
},
{
"actual": "0.1%",
"actual_better_worse": "worse",
"date": "Jul 30, 2026",
"event_id": 148233,
"forecast": "0.2%",
"impact": "high",
"previous": "0.3%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=jul30.2026#detail=148233"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Jun 25, 2026",
"event_id": 148232,
"forecast": "0.3%",
"impact": "high",
"previous": "0.2%",
"revision": "0.3%",
"revision_better_worse": "better",
"url": "https://www.forexfactory.com/calendar?day=jun25.2026#detail=148232"
},
{
"actual": "0.2%",
"actual_better_worse": "worse",
"date": "May 28, 2026",
"event_id": 148231,
"forecast": "0.3%",
"impact": "high",
"previous": "0.3%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=may28.2026#detail=148231"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Apr 30, 2026",
"event_id": 148230,
"forecast": "0.3%",
"impact": "high",
"previous": "0.4%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=apr30.2026#detail=148230"
},
{
"actual": "0.4%",
"actual_better_worse": null,
"date": "Apr 9, 2026",
"event_id": 148229,
"forecast": "0.4%",
"impact": "high",
"previous": "0.4%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=apr9.2026#detail=148229"
},
{
"actual": "0.4%",
"actual_better_worse": null,
"date": "Mar 13, 2026",
"event_id": 152086,
"forecast": "0.4%",
"impact": "high",
"previous": "0.4%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=mar13.2026#detail=152086"
},
{
"actual": "0.4%",
"actual_better_worse": "better",
"date": "Feb 20, 2026",
"event_id": 152042,
"forecast": "0.3%",
"impact": "high",
"previous": "0.2%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=feb20.2026#detail=152042"
},
{
"actual": "0.2%",
"actual_better_worse": null,
"date": "Jan 22, 2026",
"event_id": 148227,
"forecast": "0.2%",
"impact": "high",
"previous": "0.2%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=jan22.2026#detail=148227"
},
{
"actual": "0.2%",
"actual_better_worse": null,
"date": "Jan 22, 2026",
"event_id": 152037,
"forecast": null,
"impact": "medium",
"previous": "0.2%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=jan22.2026#detail=152037"
},
{
"actual": "0.2%",
"actual_better_worse": null,
"date": "Dec 5, 2025",
"event_id": 150985,
"forecast": "0.2%",
"impact": "high",
"previous": "0.2%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=dec5.2025#detail=150985"
},
{
"actual": "0.2%",
"actual_better_worse": null,
"date": "Sep 26, 2025",
"event_id": 142513,
"forecast": "0.2%",
"impact": "high",
"previous": "0.3%",
"revision": "0.2%",
"revision_better_worse": "worse",
"url": "https://www.forexfactory.com/calendar?day=sep26.2025#detail=142513"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Aug 29, 2025",
"event_id": 142512,
"forecast": "0.3%",
"impact": "high",
"previous": "0.3%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=aug29.2025#detail=142512"
},
{
"actual": "0.3%",
"actual_better_worse": null,
"date": "Jul 31, 2025",
"event_id": 142511,
"forecast": "0.3%",
"impact": "high",
"previous": "0.2%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=jul31.2025#detail=142511"
},
{
"actual": "0.2%",
"actual_better_worse": "better",
"date": "Jun 27, 2025",
"event_id": 142510,
"forecast": "0.1%",
"impact": "high",
"previous": "0.1%",
"revision": null,
"revision_better_worse": null,
"url": "https://www.forexfactory.com/calendar?day=jun27.2025#detail=142510"
}
],
"has_data_values": true,
"has_more": true,
"observed_at_ms": 1791018187423,
"source_url": "https://www.forexfactory.com/calendar/history/1-148235?i=1"
}
```
### List events
- Capability: `economic-calendar/list_events`
- Description: List the economic calendar events of one day, week, month or custom date range (at most 62 days), optionally filtered by impact, currency and event type. Returns each event's identifiers, scheduled time (epoch seconds and UTC), impact, actual, forecast, previous and revision values as the site states them (empty values are null). Parsed from the calendar page's inline state (same data the site's calendar app renders).
- Instructions: To see what is scheduled or was released in a date window, or to find an event_id to pass to event_detail, event_history or event_graph.
- Cost: 5 credits per call
- Capability file: [List events](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/list_events)
Accepted options:
- `currencies` (string[]): Keep only events of these currencies (the nine the site filters on). Default: all. Example: `[]`
- `date` (string): Anchor date, YYYY-MM-DD. Defaults to today (UTC). Mutually exclusive with `start`/`end`. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: ``
- `end` (string): Custom range end, YYYY-MM-DD (requires `start`). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: ``
- `event_types` (string[]): Keep only these site event-type categories. Default: all. Example: `[]`
- `impacts` (string[]): Keep only these impact levels (`holiday` is the site's Non-Economic grey level). Default: all. Example: `[]`
- `start` (string): Custom range start, YYYY-MM-DD (requires `end`; at most 62 days inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: ``
- `view` (string): Window around `date`: the day itself, the Sunday-to-Saturday week containing it, or its calendar month. Ignored when `start`/`end` are given. Example: `week`
Response schema example:
```json
{
"end_date": "2026-09-30",
"event_count": 2,
"events": [
{
"actual": "0.2%",
"actual_better_worse": "worse",
"country": "US",
"currency": "USD",
"date": "2026-09-30",
"dateline": 1790771400,
"datetime_utc": "2026-09-30T12:30:00Z",
"ebase_id": 85,
"event_id": 148235,
"forecast": "0.3%",
"has_data_values": true,
"has_graph": true,
"impact": "high",
"impact_title": "High Impact Expected",
"leaked": false,
"name": "Core PCE Price Index m/m",
"notice": null,
"prefixed_name": "US Core PCE Price Index m/m",
"previous": "0.2%",
"revision": "0.1%",
"revision_better_worse": "worse",
"solo_url": "https://www.forexfactory.com/calendar/85-us-core-pce-price-index-mm",
"time_label": "7:30am",
"time_masked": false,
"url": "https://www.forexfactory.com/calendar?day=sep30.2026#detail=148235"
},
{
"actual": "2.2%",
"actual_better_worse": "better",
"country": "US",
"currency": "USD",
"date": "2026-09-30",
"dateline": 1790771400,
"datetime_utc": "2026-09-30T12:30:00Z",
"ebase_id": 28,
"event_id": 148310,
"forecast": "1.5%",
"has_data_values": true,
"has_graph": true,
"impact": "high",
"impact_title": "High Impact Expected",
"leaked": false,
"name": "Final GDP q/q",
"notice": null,
"prefixed_name": "US Final GDP q/q",
"previous": "1.5%",
"revision": null,
"revision_better_worse": null,
"solo_url": "https://www.forexfactory.com/calendar/28-us-final-gdp-qq",
"time_label": "7:30am",
"time_masked": false,
"url": "https://www.forexfactory.com/calendar?day=sep30.2026#detail=148310"
}
],
"filters": {
"currencies": [
"USD"
],
"event_types": [
"growth",
"inflation",
"employment",
"central_bank",
"bonds",
"housing",
"consumer_surveys",
"business_surveys",
"speeches",
"misc"
],
"impacts": [
"high"
]
},
"navigation": {
"current_url": "https://www.forexfactory.com/calendar?day=sep30.2026",
"next_url": "https://www.forexfactory.com/calendar?day=oct1.2026",
"previous_url": "https://www.forexfactory.com/calendar?day=sep29.2026"
},
"observed_at_ms": 1791018156541,
"source_url": "https://www.forexfactory.com/calendar?day=sep30.2026&permalink=true&impacts=3&event_types=1,2,3,4,5,7,8,9,10,11¤cies=9",
"start_date": "2026-09-30",
"timezone": "America/Chicago",
"view": "day"
}
```
### Search events
- Capability: `economic-calendar/search_events`
- Description: Search calendar indicators by name (the calendar's autocomplete). Returns matching indicator series with their ebase_id, slug, impact and solo page URL.
- Instructions: To find an indicator series (e.g. `cpi`, `nonfarm`) before listing its releases; the result has no per-release event_id, use list_events for those.
- Cost: 5 credits per call
- Capability file: [Search events](https://firecrawl.dev/alexandria/agents/providers/forexfactory-com/economic-calendar/search_events)
Accepted options:
- `query` (string, required): Indicator name fragment, e.g. `cpi`, `nonfarm`, `rate decision`. Example: ``
Response schema example:
```json
{
"observed_at_ms": 1791018164705,
"query": "cpi",
"result_count": 15,
"results": [
{
"ebase_id": 79,
"impact": "high",
"name": "US Core CPI m/m",
"slug": "us-core-cpi-mm",
"solo_url": "https://www.forexfactory.com/calendar/79-us-core-cpi-mm"
},
{
"ebase_id": 78,
"impact": "high",
"name": "US CPI m/m",
"slug": "us-cpi-mm",
"solo_url": "https://www.forexfactory.com/calendar/78-us-cpi-mm"
},
{
"ebase_id": 884,
"impact": "high",
"name": "US CPI y/y",
"slug": "us-cpi-yy",
"solo_url": "https://www.forexfactory.com/calendar/884-us-cpi-yy"
},
{
"ebase_id": 85,
"impact": "high",
"name": "US Core PCE Price Index m/m",
"slug": "us-core-pce-price-index-mm",
"solo_url": "https://www.forexfactory.com/calendar/85-us-core-pce-price-index-mm"
},
{
"ebase_id": 82,
"impact": "high",
"name": "UK CPI y/y",
"slug": "uk-cpi-yy",
"solo_url": "https://www.forexfactory.com/calendar/82-uk-cpi-yy"
},
{
"ebase_id": 80,
"impact": "high",
"name": "CA CPI m/m",
"slug": "ca-cpi-mm",
"solo_url": "https://www.forexfactory.com/calendar/80-ca-cpi-mm"
},
{
"ebase_id": 933,
"impact": "high",
"name": "US Core CPI y/y",
"slug": "us-core-cpi-yy",
"solo_url": "https://www.forexfactory.com/calendar/933-us-core-cpi-yy"
},
{
"ebase_id": 888,
"impact": "high",
"name": "AU CPI y/y",
"slug": "au-cpi-yy",
"solo_url": "https://www.forexfactory.com/calendar/888-au-cpi-yy"
},
{
"ebase_id": 659,
"impact": "high",
"name": "CA Median CPI y/y",
"slug": "ca-median-cpi-yy",
"solo_url": "https://www.forexfactory.com/calendar/659-ca-median-cpi-yy"
},
{
"ebase_id": 98,
"impact": "high",
"name": "AU CPI m/m",
"slug": "au-cpi-mm",
"solo_url": "https://www.forexfactory.com/calendar/98-au-cpi-mm"
},
{
"ebase_id": 657,
"impact": "high",
"name": "CA Trimmed CPI y/y",
"slug": "ca-trimmed-cpi-yy",
"solo_url": "https://www.forexfactory.com/calendar/657-ca-trimmed-cpi-yy"
},
{
"ebase_id": 99,
"impact": "high",
"name": "AU Trimmed Mean CPI m/m",
"slug": "au-trimmed-mean-cpi-mm",
"solo_url": "https://www.forexfactory.com/calendar/99-au-trimmed-mean-cpi-mm"
},
{
"ebase_id": 173,
"impact": "high",
"name": "NZ CPI q/q",
"slug": "nz-cpi-qq",
"solo_url": "https://www.forexfactory.com/calendar/173-nz-cpi-qq"
},
{
"ebase_id": 100,
"impact": "medium",
"name": "SZ CPI m/m",
"slug": "sz-cpi-mm",
"solo_url": "https://www.forexfactory.com/calendar/100-sz-cpi-mm"
},
{
"ebase_id": 169,
"impact": "medium",
"name": "GE Prelim CPI m/m",
"slug": "ge-prelim-cpi-mm",
"solo_url": "https://www.forexfactory.com/calendar/169-ge-prelim-cpi-mm"
}
],
"source_url": "https://www.forexfactory.com/calendar/search?solo=1&q=cpi"
}
```