Why Choose FinanceFlow Economic Calendar API?

FinanceFlowAPI’s economic events api delivers reliable, structured macro 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 EM — a true world economic calendar.
• 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 a global economic calendar API with country filters and date ranges.

List Supported Countries with /calendar-catalog

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"},
        ...
    ]
}
    

Python Example:

import requests

API_KEY = 'your_api_key_here'
url = f'https://financeflowapi.com/api/v1/calendar-catalog?api_key={API_KEY}'

response = requests.get(url)
print(response.json())
    

Access Events with /financial-calendar

Fetch upcoming events for a country or globally (max 60 days ahead). Fields include country, report_name, previous, consensus, actual (when published), economicImpact, and datetime.

Request Parameters:

• country (string, required): e.g., "United States" (or leave empty for global)
• date_from (string, optional): YYYY-MM-DD
• date_to (string, optional): YYYY-MM-DD
• api_key (string, required): your unique API key

Request Example:

GET https://financeflowapi.com/api/v1/financial-calendar?api_key=YOUR_API_KEY&country=United States&date_from=2025-03-01&date_to=2025-03-07

Response Example:

{
    "success": true,
    "code": 200,
    "message": "OK",
    "meta": {
        "timestamp": 1740778240,
        "request_id": "67c22b003df2b"
    },
    "data": [
        {
            "country": "United States",
            "report_name": "S&P Global Manufacturing PMI Final",
            "actual": "",
            "previous": "51.2",
            "consensus": "51.6",
            "economicImpact": "Moderate",
            "report_date": "02",
            "datetime": "2025-03-03 14:45:00"
        },
        ...
    ]
}
    

Python Example:

import requests

API_KEY = 'your_api_key_here'
url = (
    'https://financeflowapi.com/api/v1/financial-calendar'
    f'?api_key={API_KEY}&country=United States&date_from=2025-03-01&date_to=2025-03-07'
)

response = requests.get(url)
print(response.json())
    

Popular Event Types

Frequently Asked Questions

Ready to Build with the Economic Calendar API?

Integrate a global economic calendar API into your apps and dashboards. Explore docs and start in minutes.

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

Start Free Now