Economic Calendar Data for Forex Markets
Economic releases can create significant changes in currency market volatility. Traders and forex applications need timely information about events such as employment reports, inflation data, interest-rate decisions, GDP releases, and central-bank announcements.
Instead of displaying a calendar manually, you can retrieve the relevant events through the EconPulse Economic Calendar API and integrate them into your own application.
With the Forex Economic Calendar API, you can retrieve events associated with major currencies and use the data to build:
- ✓ Forex economic calendars
- ✓ High-impact event monitors
- ✓ Trading dashboards
- ✓ Economic news alerts
- ✓ Market analysis tools
- ✓ Event-driven trading systems
- ✓ Risk management applications
- ✓ Trading bots and automated workflows
What Data Can You Get?
Each economic event returned by GET /economic-events/filter contains the fields needed to identify and evaluate a scheduled market release.
Event date and time
Use occurrence_time (UTC) for the scheduled release so your application can display upcoming events or trigger time-based workflows.
Currency
Identify the currency associated with the release via the currency field — for example USD, EUR, GBP, JPY, CHF, CAD, AUD, and NZD — so you can build currency-specific forex calendars.
Importance level
Events are classified as low, medium, or high via the importance field.
Filter with importance=high to show only potentially market-moving releases for USD, EUR, GBP, and other pairs.
Forecast, previous, and actual
Before a release, use forecast and previous. After publication, actual becomes available so your app can compare
actual vs forecast vs previous.
EconPulse also exposes comparison hints such as actual_to_forecast (positive / negative / neutral).
Localized event names
Titles are available as short_name and long_name, localizable with the lang parameter across up to 23 languages — useful for multilingual broker UIs.
Forex Economic Events
The API returns many of the macroeconomic releases followed by forex traders — as structured rows rather than scraped HTML.
Employment data
- • Non-Farm Payrolls (NFP)
- • Unemployment Rate
- • Employment Change
- • Initial Jobless Claims
- • Average Hourly Earnings
Inflation data
- • Consumer Price Index (CPI)
- • Core CPI
- • Producer Price Index (PPI)
- • Core PPI
Central bank events
- • Federal Reserve rate decisions
- • ECB rate decisions
- • Bank of England decisions
- • Bank of Japan decisions
- • Statements and speeches
Economic growth
- • GDP
- • Industrial Production
- • Retail Sales
- • Manufacturing data
- • Services activity
Filter Economic Events for Forex Trading
A forex application rarely needs every economic event in the world. A trader monitoring EUR/USD may primarily need important releases for the United States and the Euro Area.
On /economic-events/filter you can narrow results with attributes such as:
- ✓
dateshortcuts (today,current_week,next_week) ordate_from/date_to - ✓
currency— e.g.USD,EUR - ✓
importance—high,medium,low - ✓
country_id— multi-value country filters - ✓
lang— localized event titles - ✓
cursor— stable pagination for large windows
High-impact forex calendar
Pass importance=high for trading dashboards, economic event alerts, risk systems, and news-aware strategies that only care about market-moving releases.
Currency-specific calendar
Build calendars around the currencies your users trade:
currency=USD&importance=highcurrency=EUR&importance=highcurrency=GBP&importance=high
Supporting lookups /langs-list and /countries-list help you populate language and country selectors in your UI.
Build a Forex Economic Calendar
Use the API to power your own calendar interface. Your application controls how the data is displayed — tables, widgets, mobile views, or internal tools.
| Time (UTC) | Currency | Event | Importance | Forecast | Previous | Actual |
|---|---|---|---|---|---|---|
| 12:30 | USD | Non-Farm Payrolls | high | — | — | — |
| 14:00 | EUR | CPI | high | — | — | — |
| 09:00 | GBP | GDP | medium | — | — | — |
Prefer to see a live UI first? Try the embedded calendar demo on the homepage, then replace it with your branded interface.
Example API Request
Authenticate with your API key, then call the filter endpoint. This example fetches today’s high-impact USD and EUR events in English:
curl --request GET \ --url 'https://api.example.com/economic-events/filter?date=today¤cy=USD,EUR&importance=high&lang=en' \ --header 'X-Api-Key: YOUR_API_KEY' \ --header 'X-Subscription: basic' \ --header 'Accept: application/json'
Example response shape (simplified):
{
"meta": {
"plan": "basic",
"returned": 1,
"next_cursor": "..."
},
"data": [
{
"occurrence_id": 62978,
"event_id": 1057,
"short_name": "Non-Farm Payrolls",
"currency": "USD",
"importance": "high",
"occurrence_time": "2026-09-04T12:30:00+00:00",
"forecast": 180,
"previous": 206,
"actual": 253,
"actual_to_forecast": "positive",
"lang": "en"
}
]
}
For authentication details, all query parameters, history by event_id, cursor pagination, export/stream endpoints, and multi-language examples, see the full documentation.
Use Forex Calendar Data in Your Trading Application
Integrate EconPulse with common languages and frameworks using standard HTTP clients.
Python
import requests url = "https://api.example.com/economic-events/filter" headers = { "X-Api-Key": "YOUR_API_KEY", "X-Subscription": "basic", "Accept": "application/json", } params = { "date": "today", "currency": "USD,EUR", "importance": "high", "lang": "en", } data = requests.get(url, headers=headers, params=params).json() print(data)
JavaScript
const url = new URL( "https://api.example.com/economic-events/filter" ); url.searchParams.set("date", "today"); url.searchParams.set("currency", "USD,EUR"); url.searchParams.set("importance", "high"); url.searchParams.set("lang", "en"); const response = await fetch(url, { headers: { "X-Api-Key": "YOUR_API_KEY", "X-Subscription": "basic", "Accept": "application/json", }, }); const data = await response.json(); console.log(data);
More complete clients (PHP, Go, Java, and runnable helpers) are in the API docs.
Forex Trading Alerts
One practical use of economic calendar data is building automated alerts. Poll or schedule calls to the filter endpoint, keep high-impact upcoming events, and notify users before a release.
Example notification copy: High-impact USD event scheduled in 30 minutes: Non-Farm Payrolls.
Economic Calendar API for Risk Management
Economic releases create periods of elevated uncertainty. A trading application can use calendar data as an input to risk rules — without treating the API as a signal service.
- ✓ Identify upcoming high-impact events
- ✓ Check which currency is affected
- ✓ Monitor time remaining until release
- ✓ Reduce exposure or pause strategies by rule
- ✓ Notify traders about upcoming releases
The API does not decide whether a trade should open or close. It provides structured event data that your application incorporates into its own logic.
Event-Driven Forex Trading
Developers can also use economic events as inputs for event-driven strategies:
occurrence_time)actual published)EconPulse supplies the underlying event information. Your trading system determines how that information is interpreted.
Why Use an API Instead of a Web Calendar?
Web calendar
- • Designed for human users
- • Requires manual interaction
- • Hard to integrate into apps
- • Limited automation
Forex Economic Calendar API
- • Designed for software
- • Machine-readable JSON
- • Programmatic access with an API key
- • Filters, history, and pagination
- • Suitable for automated workflows
Who Is This API For?
Forex trading platforms
Add economic events to your trading interface without maintaining a separate calendar data pipeline.
Trading dashboard developers
Display upcoming releases alongside prices, indicators, and other market data.
Fintech applications
Integrate macroeconomic events into financial products and research tools, including multilingual UIs.
Trading bot developers
Use scheduled economic events as an additional input to automated systems and risk gates.
Forex analysts
Retrieve structured event data for analysis, monitoring, and reporting — with history since 2005 via /economic-events/{event_id}/history.
Alert and notification services
Build automated notifications around upcoming high-impact releases.
Supported Forex Currencies
Organize events by associated currency and create customized calendars for major pairs and other supported codes.
USD · EUR · GBP · JPY · CHF · CAD · AUD · NZD
Coverage spans 160+ countries. Check the documentation and /countries-list for current country IDs and filter options.
Build Your Own Forex Economic Calendar
You don’t need to maintain the underlying economic event database yourself. With EconPulse your team can:
- Request events through
GET /economic-events/filter - Filter by currency, importance, date, and country for your users
- Store or process the returned JSON (with cursor pagination as needed)
- Display events in your own interface
- Trigger alerts or application workflows
That lets your development team focus on product experience rather than calendar infrastructure.
Forex Economic Calendar API FAQ
What is a Forex Economic Calendar API?
A Forex Economic Calendar API provides structured economic event data for forex trading applications, dashboards, alert systems, and automated workflows. Instead of reading a web calendar manually, software retrieves events programmatically as JSON.
What forex events can I retrieve?
Depending on coverage, events include employment reports, inflation releases, GDP, retail sales, interest-rate decisions, central-bank announcements, and other macroeconomic indicators across 160+ countries.
Does the API provide forecast, previous, and actual values?
Yes. Rows can include forecast and previous before a release and actual after publication, plus comparison fields such as actual_to_forecast.
Can I filter events by currency?
Yes. Pass currency=USD or comma-separated lists like USD,EUR,GBP on /economic-events/filter to focus on the currencies your users trade.
Can I retrieve high-impact forex events only?
Yes. Use importance=high (or combinations such as high,medium) to build calendars and alerts around higher-impact releases.
Can I use the API with Python?
Yes. Call the API host with standard HTTP libraries such as requests. Full examples are in the documentation.
Can I use the API for a trading bot?
Yes. The API can supply economic event information to a trading system. Your application decides how to use that information under its own trading and risk-management rules.
Is this a forex price API?
No. EconPulse focuses on economic event calendar data. It is not a replacement for a real-time forex price or market-data feed.
Where can I find the API documentation?
See the complete EconPulse documentation for authentication, endpoints, parameters, response formats, and integration examples.
Start Building With Forex Economic Calendar Data
Build your own forex calendar, trading dashboard, economic event monitor, or automated alert system using structured economic event data from EconPulse.