Economic Calendar API for trading systems, dashboards, and macro workflows
Access structured economic events from major economies worldwide, including GDP, inflation, employment, central bank decisions, and other macro signals that move financial markets.
Product overview
Built for products that need macro event timing, volatility context, and cleaner economic scheduling in one API workflow.
5 min
Auto-update cycle
25+
GMT timezones
25+
Structured fields per event
Coverage
Major economies, scheduled macro releases, and central-bank event coverage.
Use
Designed for trading desks, dashboards, alerts, research tools, and fintech apps.
Output
JSON-first responses with volatility context, time handling, and event metadata.
Delivery
Accessible through RapidAPI with simple integration and production-ready access.
Feature set
Macro event infrastructure built for real product usage
Everything needed to power economic event surfaces with structured data, refresh cadence, and reliable metadata.
Comprehensive economic coverage
Track GDP, inflation, labor data, central bank decisions, trade balance releases, and other market-moving indicators.
Multi-timezone support
Convert events across 25+ GMT timezones to keep calendars aligned with product regions and trading sessions.
Rich event metadata
Use volatility classifications, event categories, identifiers, and scoring-related attributes for deeper logic.
Expectation and deviation context
Evaluate actual, previous, consensus, and ratio-deviation values to understand surprise and macro impact.
Frequent refresh cadence
A five-minute update cycle helps products stay current when schedules shift or new releases are published.
Developer-friendly delivery
Integrate through predictable JSON responses, flexible filters, and a product-ready endpoint structure.
Use cases
Designed for teams that operate around market-moving events
From trading automation to macro research, the API is structured for workflows that need reliable event timing and impact awareness.
Algorithmic trading systems
Support event-driven strategies, volatility preparation, and scheduling logic around macro releases.
Financial dashboards
Display upcoming releases, market-sensitive events, and historical economic context inside trading or analytics products.
Macroeconomic research
Use structured event data for policy tracking, forecasting workflows, and region-by-region comparisons.
Investment decision support
Inform timing, allocation, and fundamental context when teams need macro inputs alongside market data.
Risk management workflows
Prepare products for high-impact releases, monitor volatility-sensitive windows, and adjust event exposure.
Market analysis products
Correlate macro releases with price behavior, surprise data, and broader market reaction patterns.
Integration guide
Start integrating in minutes
Use the snippets below to connect quickly through RapidAPI and test the economic calendar endpoints in your preferred language.
Integration note
Replace `Your_API_KEY` with your active RapidAPI key before sending requests.
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://economic-calendar-api.p.rapidapi.com/country',
headers: {
'x-rapidapi-key': 'Your_API_KEY',
'x-rapidapi-host': 'economic-calendar-api.p.rapidapi.com'
}
};
async function fetchData() {
try {
const response = await axios.request(options);
console.log(response.data);
} catch (error) {
console.error(error);
}
}
fetchData();Need more examples, params, or endpoint details? Browse the full documentation.
Open docsEndpoint map
A small endpoint surface with practical economic filters
The API is intentionally straightforward, with a compact set of routes for event retrieval, country references, and timezone support.
/calendarRetrieve economic calendar data with country, volatility, date, limit, and timezone filtering.
/calendar/{id}Fetch a single event by unique identifier with full event-level metadata.
/countryReturn supported countries and ISO country codes for calendar filtering and coverage setup.
/timezoneList GMT-12 through GMT+12 timezone options available for calendar conversion workflows.
All endpoints return standardized JSON responses built for consistent ingestion in trading tools, dashboards, and analytics applications.
View complete documentationResponse structure
Rich event fields for scheduling, analysis, and macro context
Economic events return detailed metadata so teams can power display logic, scoring, comparisons, and event-based workflows.
idUnique identifier for the event
eventIdEvent-level tracking identifier
nameEconomic event name
countryCodeISO country code
dateUtcUTC timestamp
volatilityNONE, LOW, MEDIUM, or HIGH classification
actualActual reported value
consensusMarket consensus value
previousPrevious reported value
ratioDeviationDeviation between actual and consensus
isBetterThanExpectedExpectation comparison indicator
isScoreTrackableTrackability for scoring workflows
Additional fields can include revised values, units, category metadata, and temporal details depending on the event record.
Example payload
{
"id": "123456",
"eventId": "event_789",
"name": "Non-Farm Payrolls",
"countryCode": "US",
"currencyCode": "USD",
"dateUtc": "2024-01-15T13:30:00.000Z",
"volatility": "HIGH",
"actual": "216K",
"consensus": "200K",
"previous": "199K",
"unit": "Jobs",
"ratioDeviation": 0.08,
"isBetterThanExpected": true,
"isScoreTrackable": true
}Expectation signal
Better-than-expected releases can be flagged for faster downstream interpretation.
Volatility layer
High-impact events can be surfaced differently inside trading and alert products.
Score support
Trackable fields help teams build historical scoring and event comparison logic.
Connected product paths
Pair macro events with price, analysis, and regional market data
Economic releases become more useful when they sit beside candle data, technical context, and market-specific datasets. These links strengthen navigation for both search engines and visitors comparing routes.
Related API
OHLC API
Use real-time and historical candles to study how markets react before and after macro releases.
Explore routeRelated API
Trading Analysis API
Layer indicators and signal logic on top of event-driven volatility windows.
Explore routeRelated API
IDX API
Combine macro awareness with Indonesia-specific equities, bonds, derivatives, and exchange activity.
Explore routeEconomic API FAQ
Questions buyers and developers usually ask first
This section mirrors the most common commercial and integration concerns around economic calendar APIs, which helps the route speak more directly to searchers evaluating providers.
What does the Economic Calendar API include?
The API covers structured macro events such as GDP releases, inflation prints, employment reports, and central bank decisions with timestamps, impact context, and comparison-friendly fields.
Is the data useful for trading workflows?
Yes. The route is positioned for event-driven trading systems, risk preparation, macro dashboards, and research workflows that need reliable event timing and high-impact release context.
Can teams filter by country and timezone?
Yes. The page already documents country, date, volatility, limit, and timezone-oriented access patterns, which makes the API easier to adapt across regional products and trading sessions.
Which related OHLC.dev routes pair best with this API?
The strongest complements are the OHLC API for price action around releases, the Trading Analysis API for indicator overlays, and the IDX API when macro awareness needs to sit beside Indonesia market data.
Launch faster with a financial API stack built for growth
Start with market data, macro events, financial news, and trading analysis from one cohesive platform designed for modern SaaS products and developer teams.
Conversion-ready setup
Everything you need to get started in minutes
Fast integration through RapidAPI
Reliable financial data coverage
Built for product teams and developers
Compare plans, explore documentation, or see how OHLC.dev positions against Finnhub, Twelve Data, and Financial Modeling Prep before you integrate.