EconPulse · Forex Calendar API

Forex Economic
Calendar API

Get structured economic calendar data for forex trading applications, market dashboards, alerts, and automated trading systems — via a simple REST API.

Retrieve event times, currencies, importance levels, forecasts, previous values, and released actuals. Build forex calendars, market alerts, event-driven tools, and economic dashboards without scraping web calendars.

2005+
Historical Data
23
Languages
160+
Countries
JSON
REST API

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.

USD EUR GBP JPY CHF CAD AUD NZD

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:

  • date shortcuts (today, current_week, next_week) or date_from / date_to
  • currency — e.g. USD,EUR
  • importancehigh, 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:

USD eventscurrency=USD&importance=high
EUR eventscurrency=EUR&importance=high
GBP eventscurrency=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
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.

View API 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.

Economic Calendar API → Filter Event → Check Time → Send Alert

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:

Scheduled event (occurrence_time)
Economic release (actual published)
Compare actual vs forecast
Your trading system processes the difference
Strategy-specific action

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:

  1. Request events through GET /economic-events/filter
  2. Filter by currency, importance, date, and country for your users
  3. Store or process the returned JSON (with cursor pagination as needed)
  4. Display events in your own interface
  5. 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.