EOD Historical Data Economic Data API
Economic events and macro indicators
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/eod-historical-economic-data-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: EODHD Financial Data Calendar Economic Data API
description: Comprehensive API for retrieving financial data including stock prices, fundamentals, calendar events, news, and more from EOD Historical Data (eodhd.com)
version: 2.0.0
contact:
name: EODHD Support
url: https://eodhd.com
email: supportlevel1@eodhistoricaldata.com
termsOfService: https://eodhd.com/financial-apis/terms-conditions
license:
name: Proprietary
url: https://eodhd.com/financial-apis/terms-conditions
servers:
- url: https://eodhd.com/api
description: Primary API path
- url: https://eodhistoricaldata.com/api
description: Alternative API path
security:
- EODHDQueryKey: []
tags:
- name: Economic Data
description: Economic events and macro indicators
paths:
/commodities/historical/{code}:
get:
summary: Get historical commodity prices
description: Returns historical price data for a specific commodity by its code (e.g., WTI, BRENT, NATURAL_GAS).
operationId: GetCommodityHistoricalData
parameters:
- name: code
in: path
required: true
description: Commodity code (e.g., 'WTI', 'BRENT', 'NATURAL_GAS', 'GOLD', 'SILVER', 'COPPER', 'PLATINUM', 'PALLADIUM', 'WHEAT', 'CORN', 'SOYBEANS', 'RICE', 'SUGAR', 'COFFEE', 'COTTON', 'COCOA', 'OATS', 'LUMBER', 'RUBBER', 'ETHANOL', 'PROPANE', 'URANIUM', 'COAL').
schema:
type: string
- name: api_token
in: query
required: true
description: API token for authentication.
schema:
type: string
- name: interval
in: query
required: false
description: Data interval — 'daily' (default), 'weekly', or 'monthly'.
schema:
type: string
enum:
- daily
- weekly
- monthly
default: daily
- name: from
in: query
required: false
description: Start date in 'YYYY-MM-DD' format.
schema:
type: string
format: date
- name: to
in: query
required: false
description: End date in 'YYYY-MM-DD' format.
schema:
type: string
format: date
- name: fmt
in: query
required: false
description: Output format.
schema:
type: string
enum:
- json
- csv
default: json
responses:
'200':
description: Successfully retrieved commodity historical data.
content:
application/json:
schema:
type: array
items:
type: object
properties:
date:
type: string
format: date
description: Data date.
open:
type: number
description: Opening price.
high:
type: number
description: High price.
low:
type: number
description: Low price.
close:
type: number
description: Closing price.
adjusted_close:
type: number
description: Adjusted closing price.
volume:
type: number
description: Trading volume.
'400':
description: Invalid request parameters.
'401':
description: Unauthorized. Invalid API token.
'404':
description: Commodity not found.
tags:
- Economic Data
/economic-events:
get:
summary: Retrieve economic events data
description: Fetches economic events by date range, country, comparison type, and other optional parameters.
operationId: GetEconomicEventsData
parameters:
- name: api_token
in: query
required: true
description: Your API key for authentication.
schema:
type: string
- name: from
in: query
required: false
description: Start date for data retrieval in 'YYYY-MM-DD' format.
schema:
type: string
format: date
- name: to
in: query
required: false
description: End date for data retrieval in 'YYYY-MM-DD' format.
schema:
type: string
format: date
- name: country
in: query
required: false
description: Country code in ISO 3166-1 alpha-2 format, e.g., 'US' for the United States.
schema:
type: string
minLength: 2
maxLength: 2
- name: comparison
in: query
required: false
description: Comparison type, e.g., 'mom' for month-over-month, 'qoq' for quarter-over-quarter, 'yoy' for year-over-year.
schema:
type: string
enum:
- mom
- qoq
- yoy
- name: offset
in: query
required: false
description: Data offset, from 0 to 1000. Default is 0.
schema:
type: integer
minimum: 0
maximum: 1000
default: 0
- name: limit
in: query
required: false
description: Number of results to return, from 0 to 1000. Default is 50.
schema:
type: integer
minimum: 0
maximum: 1000
default: 50
responses:
'200':
description: Successfully retrieved economic events data.
content:
application/json:
schema:
type: array
items:
type: object
properties:
type:
type: string
description: Type of economic event, e.g., 'Nonfarm Payrolls'.
comparison:
type:
- string
- 'null'
description: Comparison type (e.g., 'mom', 'qoq', 'yoy').
period:
type:
- string
- 'null'
description: Period associated with the data, e.g., 'May'.
country:
type: string
description: Country code in ISO 3166 format.
date:
type: string
format: date-time
description: Date and time of the event in 'YYYY-MM-DD HH:MM:SS' format.
actual:
type:
- number
- 'null'
description: Actual reported value for the event.
previous:
type:
- number
- 'null'
description: Previous value for the event.
estimate:
type:
- number
- 'null'
description: Estimated value for the event.
change:
type:
- number
- 'null'
description: Change in value from previous.
change_percentage:
type:
- number
- 'null'
description: Percentage change in value from previous.
example:
- type: Participation Rate
comparison: ''
period: May
country: US
date: '2022-06-03 16:30:00'
actual: 62.3
previous: 62.2
estimate: ''
change: 0.1
change_percentage: 0.161
- type: Nonfarm Payrolls Private
comparison: ''
period: May
country: US
date: '2022-06-03 16:30:00'
actual: 333
previous: 405
estimate: 325
change: -72
change_percentage: -17.778
'400':
description: Invalid request parameters.
'401':
description: Unauthorized. Invalid API token.
'404':
description: No economic events data found for the specified parameters.
tags:
- Economic Data
/macro-indicator/{country}:
get:
summary: Retrieve macroeconomic indicators for a specific country
description: Fetches macroeconomic data for a selected indicator, such as GDP or inflation, by country code.
operationId: GetMacroIndicatorData
parameters:
- name: country
in: path
required: true
description: Country code in ISO Alpha-3 format (e.g., 'USA' for United States, 'FRA' for France).
schema:
type: string
- name: api_token
in: query
required: true
description: Your API token for authentication.
schema:
type: string
- name: indicator
in: query
required: false
description: The macroeconomic indicator to retrieve. Default is 'gdp_current_usd'.
schema:
type: string
enum:
- real_interest_rate
- population_total
- population_growth_annual
- inflation_consumer_prices_annual
- consumer_price_index
- gdp_current_usd
- gdp_per_capita_usd
- gdp_growth_annual
- debt_percent_gdp
- net_trades_goods_services
- inflation_gdp_deflator_annual
- agriculture_value_added_percent_gdp
- industry_value_added_percent_gdp
- services_value_added_percent_gdp
- exports_of_goods_services_percent_gdp
- imports_of_goods_services_percent_gdp
- gross_capital_formation_percent_gdp
- net_migration
- gni_usd
- gni_per_capita_usd
- gni_ppp_usd
- gni_per_capita_ppp_usd
- income_share_lowest_twenty
- life_expectancy
- fertility_rate
- prevalence_hiv_total
- co2_emissions_tons_per_capita
- surface_area_km
- poverty_poverty_lines_percent_population
- revenue_excluding_grants_percent_gdp
- cash_surplus_deficit_percent_gdp
- startup_procedures_register
- market_cap_domestic_companies_percent_gdp
- mobile_subscriptions_per_hundred
- internet_users_per_hundred
- high_technology_exports_percent_total
- merchandise_trade_percent_gdp
- total_debt_service_percent_gni
- unemployment_total_percent
default: gdp_current_usd
- name: fmt
in: query
required: false
description: 'Output format: ''json'' or ''csv''. Default is ''json''.'
schema:
type: string
enum:
- json
- csv
default: json
responses:
'200':
description: Successfully retrieved macroeconomic data.
content:
application/json:
schema:
type: array
items:
type: object
properties:
CountryCode:
type: string
description: ISO Alpha-3 country code, e.g., 'USA' for United States.
CountryName:
type: string
description: Country name, e.g., 'United States'.
Indicator:
type: string
description: Indicator name, e.g., 'Inflation, consumer prices (annual %)'.
Date:
type: string
format: date
description: Date of the recorded value.
Period:
type: string
description: Period of the data, e.g., 'Annual'.
Value:
type: number
description: Recorded value of the indicator.
example:
- CountryCode: USA
CountryName: United States
Indicator: Inflation, consumer prices (annual %)
Date: '2023-12-31'
Period: Annual
Value: 4.1163
- CountryCode: USA
CountryName: United States
Indicator: Inflation, consumer prices (annual %)
Date: '2022-12-31'
Period: Annual
Value: 8.0028
'400':
description: Invalid request parameters.
'401':
description: Unauthorized. Invalid API token.
'404':
description: Data not found for the specified country or indicator.
tags:
- Economic Data
components:
securitySchemes:
EODHDQueryKey:
type: apiKey
in: query
name: api_token
description: EODHD API key (stored as a secret in ChatGPT).