Global Economic Calendar API

Technical Specifications & Uptime

FinanceFlowAPI delivers reliable structured macroeconomic event data for 100+ countries to power trading strategies, alerts, and research.

• Near-real-time Economic Calendar: Updates every 5–10 minutes after official announcements, with precise timestamps and verified sources.
• Global Coverage: From the U.S. and EU to APAC and emerging markets, with worldwide macroeconomic event coverage.
• Actionable Fields: Previous, consensus, actual, and impact level for each event.
• Simple Integration: Clean JSON over HTTPS; copy-paste code samples for instant results.
• Plan Ahead: Query up to 60 days forward to prepare for volatility.

Pricing Plans

For detailed pricing, visit FinanceFlowAPI Pricing.

Use Cases for the Economic Calendar API

• Trading Bots: Avoid high-volatility windows or place event-driven orders.
• Investor Dashboards: Show upcoming economic indicators with impact badges.
• Research & Analytics: Compare actual vs. consensus across countries.
• Alerts & Notifications: Push “real-time economic calendar” updates to users.

What Is an Economic Calendar?

An economic calendar API lists scheduled macroeconomic events that can move markets: PMI, GDP, CPI, jobs data, central bank decisions, and speeches. FinanceFlow provides a unified schema for accessing global macroeconomic calendar data with country filters and date ranges.

Economic Calendar API Endpoints

/calendar-catalog — List Supported Countries

Retrieve a list of countries available in the economic events api.

Request Example:

GET https://financeflowapi.com/api/v1/calendar-catalog?api_key=YOUR_API_KEY

Response Example:

{
    "success": true,
    "code": 200,
    "message": "OK",
    "meta": {
        "timestamp": 1740778132,
        "request_id": "67c22a948bc91"
    },
    "data": [
        {"country": "Afghanistan"},
        {"country": "Albania"},
        ...
    ]
}
    

/financial-calendar — Get Macroeconomic Events

Query upcoming or historical economic events with country filters, date ranges, and impact levels.

Request Example:

GET https://financeflowapi.com/api/v1/financial-calendar?api_key=YOUR_API_KEY&country=United%20States&date_from=2026-05-24

Response Example:

{
    "success": true,
    "code": 200,
    "meta": {
        "timestamp": 1740778132
    },
    "data": [
        {
            "datetime": "2026-05-28 12:30:00",
            "country": "United States",
            "report_name": "Core PCE Price Index (MoM)",
            "economicImpact": "Major",
            "previous": "0.3%",
            "forecast": "0.2%",
            "actual": null
        }
    ]
}

Real-World Example: Filter High-Impact Events(Major) Only

Most traders only care about Major and Moderate impact events. Here's how to filter them:

Python with Filtering and Error Handling:

import requests
from datetime import datetime, timedelta

API_KEY = 'your_api_key_here'
base_url = 'https://financeflowapi.com/api/v1/financial-calendar'

# Get events for next 7 days
today = datetime.now().strftime('%Y-%m-%d')
week_ahead = (datetime.now() + timedelta(days=7)).strftime('%Y-%m-%d')

params = {
    'api_key': API_KEY,
    'country': 'United States',
    'date_from': today,
    'date_to': week_ahead
}

response = requests.get(base_url, params=params)

if response.status_code == 200:
    data = response.json()
    # Filter only Major impact events
    high_impact = [e for e in data['data'] if e['economicImpact'] == 'Major']
    print(f"Found {len(high_impact)} high-impact events this week")
    for event in high_impact:
        print(f"{event['datetime']}: {event['report_name']} - Previous: {event['previous']}")
else:
    print(f"Error {response.status_code}: {response.text}")

JavaScript (Node.js) with Async/Await:

const axios = require('axios');

const API_KEY = 'your_api_key_here';
const url = 'https://financeflowapi.com/api/v1/financial-calendar';

async function getHighImpactEvents(country, days = 7) {
    try {
        const response = await axios.get(url, {
            params: {
                api_key: API_KEY,
                country: country,
                date_from: new Date().toISOString().split('T')[0]
            }
        });
        
        const highImpact = response.data.data.filter(e => e.economicImpact === 'Major');
        console.log(`${highImpact.length} high-impact events for ${country}`);
        return highImpact;
    } catch (error) {
        console.error('API Error:', error.response?.data || error.message);
    }
}

getHighImpactEvents('United States');

Financial Calendar API Documentation

Why Developers Trust FinanceFlow

• Structured machine-readable JSON
• Reliable update intervals
• Global macroeconomic coverage
• Simple REST API integration
• Historical actual vs forecast values

Popular Event Types

Frequently Asked Questions

Production Deployment

Integrate global macroeconomic event data into your apps, trading systems, and dashboards. Explore docs and start in minutes.

Docs: Financial Calendar API on GitHub • Account: Create Account

Get Test Plan API Key