Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

EODHD Financial Data API

The full EODHD REST surface — 83 operations across end-of-day and intraday prices, fundamentals, calendars, news and sentiment, options, indices, screening, macro and credit-risk data, sanctions, ESG, and marketplace analytics — captured from the provider's official OpenAPI 3.1.0 specification.

EODHD Financial Data API is one of 11 APIs that EODHD publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Financial, Market Data, Fundamentals, Options, and News. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 83 operations across 83 paths, organized into 25 resource areas, and defines 72 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against 2 base URLs: https://eodhd.com/api, https://eodhistoricaldata.com/api.

83 operations 83 paths 72 schemas 83 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://eodhd.com/api
Authentication
API Key
Terms of Service
Resource Areas
25

Authentication & Security 1

EODHD Financial Data API declares 1 security scheme for authenticating requests. An API key is passed in the query as api_token (EODHDQueryKey). By default, every request must be authenticated.

  • EODHDQueryKey — EODHD API key (stored as a secret in ChatGPT).

Paths & Operations 83

Across 83 paths, the API surfaces 83 operations — 83 GET. They span 25 resource areas, including Fundamentals, Calendar, Economic Data, Credit & Sovereign Risk, CBOE, Dividends & Splits, End-of-Day Data, Exchanges, and 17 more. Each is listed below with its method, path, parameters, and response codes.

Fundamentals 4

Fundamental data for stocks and companies

GET
/bulk-fundamentals/{EXCHANGE}
Retrieve bulk fundamental data for an exchange
GetBulkFundamentals 6 params → 200400401404
GET
/fundamentals/{ticker}
Retrieve filtered fundamental data for a specific symbol
GetFundamentalData 7 params → 200400401404
GET
/v1.1/bulk-fundamentals/{EXCHANGE}
Retrieve bulk fundamental data for an exchange (v1.1)
GetBulkFundamentalsV1_1 6 params → 200400401404
GET
/v1.1/fundamentals/{ticker}
Retrieve filtered fundamental data for a specific symbol (v1.1)
GetFundamentalDataV1_1 7 params → 200400401404
Calendar 5

Calendar events including earnings, IPOs, splits, dividends, and trends

GET
/calendar/dividends
Retrieve upcoming dividends calendar
GetUpcomingDividends 7 params → 200401422
GET
/calendar/earnings
Retrieve upcoming earnings data
GetUpcomingEarnings 4 params → 200400401404
GET
/calendar/ipos
Retrieve upcoming IPO data
GetUpcomingIPOs 3 params → 200400401404
GET
/calendar/splits
Retrieve upcoming and historical stock splits
GetUpcomingSplits 3 params → 200400401404
GET
/calendar/trends
Retrieve earnings trends data
GetEarningsTrends 2 params → 200400401404
Economic Data 3

Economic events and macro indicators

GET
/commodities/historical/{code}
Get historical commodity prices
GetCommodityHistoricalData 5 params → 200400401404
GET
/economic-events
Retrieve economic events data
GetEconomicEventsData 6 params → 200400401404
GET
/macro-indicator/{country}
Retrieve macroeconomic indicators for a specific country
GetMacroIndicatorData 3 params → 200400401404
Credit & Sovereign Risk 7

Sovereign risk premiums, credit ratings, CDS spreads, and corporate credit metrics

GET
/credit-risk/sovereign/risk-premium
Get sovereign country risk premiums
GetSovereignRiskPremium 6 params → 200401403404422429
GET
/credit-risk/sovereign/credit-ratings
Get sovereign credit ratings
GetSovereignCreditRatings 5 params → 200401403404422429
GET
/credit-risk/sovereign/cds-spreads
Get sovereign CDS spreads
GetSovereignCdsSpreads 5 params → 200401403404422429
GET
/credit-risk/sovereign/default-spreads
Get default spreads by rating
GetSovereignDefaultSpreads 5 params → 200401403404422429
GET
/credit-risk/corporate/cmdi
Get corporate market debt indices (CMDI)
GetCorporateCmdi 5 params → 200401403404422429
GET
/credit-risk/corporate/hqm-yields
Get high quality market (HQM) corporate bond yields
GetCorporateHqmYields 7 params → 200401403404422429
GET
/credit-risk/cds-market/aggregates
Get CDS market aggregate statistics
GetCdsMarketAggregates 9 params → 200401403404422429
CBOE 2

CBOE index data and listings

GET
/cboe/index
Get CBOE index historical data
GetCBOEIndexData 5 params → 200400401404
GET
/cboe/indices
List CBOE indices
GetCBOEIndices 1 param → 200401429
Dividends & Splits 2

Dividend and split history

GET
/div/{ticker}
Retrieve historical dividend data
GetHistoricalDividends 4 params → 200400401404
GET
/splits/{ticker}
Retrieve historical split data
GetHistoricalSplits 4 params → 200400401404
End-of-Day Data 2

Historical and current end-of-day price data

GET
/eod/{ticker}
Retrieve end-of-day historical price data
GetEODDataByTicker 6 params → 200400401404
GET
/eod-bulk-last-day/{exchange}
Retrieve bulk EOD, splits, or dividends data
GetBulkEODData 6 params → 200400401404
Exchanges 6

Exchange information and symbols

GET
/exchange-details/{EXCHANGE_CODE}
Retrieve details for a specific exchange
GetExchangeDetails 5 params → 200400401404
GET
/exchange-symbol-list/{exchangeCode}
Retrieve the list of tickers for a specific exchange.
GetExchangeSymbolList 4 params → 200400401
GET
/exchanges-list
List supported exchanges
GetListOfExchanges 1 param → 200400401
GET
/id-mapping
Map between financial identifiers
GetIdMapping 10 params → 200400401
GET
/v2/exchange-details
List available exchanges (v2)
ListExchangeDetailsV2 → 200401
GET
/v2/exchange-details/{code}
Get exchange details and trading hours (v2)
GetExchangeDetailsV2 1 param → 200401404
Market Data 1

Market capitalization and other market data

GET
/historical-market-cap/{ticker}
Retrieve historical market capitalization data
GetHistoricalMarketCap 5 params → 200400401404
Corporate Actions 2

Symbol changes and insider transactions

GET
/insider-transactions
Retrieve insider transaction data
GetInsiderTransactions 5 params → 200400401404
GET
/symbol-change-history
Retrieve symbol change history
GetSymbolChangeHistory 4 params → 200400401404
User 2

User account and subscription information

GET
/internal-user
Retrieve internal user account information
GetInternalUserInfo → 200400401404
GET
/user
Get current user details
GetUserDetails 1 param → 200401
Intraday Data 1

Intraday historical price data (time-based bars)

GET
/intraday/{ticker}
Retrieve intraday historical price data
GetIntradayHistoricalData 5 params → 200400401404
Logos 2

Company and ticker logos

GET
/logo/{symbol}
Get ticker logo (PNG)
getTickerLogo 1 param → 200401403404429
GET
/logo-svg/{symbol}
Get ticker logo (SVG)
getTickerLogoSvg 1 param → 200401403404429
ESG 6

Environmental, Social, and Governance ratings (Investverte)

GET
/mp/investverte/companies
List ESG-rated companies
GetESGCompanies 1 param → 200401429
GET
/mp/investverte/countries
List ESG country scores
GetESGCountries 1 param → 200401429
GET
/mp/investverte/country/{symbol}
Get ESG country details
GetESGCountryDetails 2 params → 200401404
GET
/mp/investverte/esg/{symbol}
Get ESG rating for a company
GetESGRating 2 params → 200401404
GET
/mp/investverte/sector/{symbol}
Get ESG sector details
GetESGSectorDetails 2 params → 200401404
GET
/mp/investverte/sectors
List ESG sector scores
GetESGSectors 1 param → 200401429
Investment Analytics 12

Risk scoring, bond analysis, bank financials, reports (PRAAMS)

GET
/mp/praams/analyse/bond/{isin}
Analyse bond by ISIN
AnalysePRAAMSBond 2 params → 200401404
GET
/mp/praams/analyse/equity/isin/{isin}
Analyse equity by ISIN
AnalysePRAAMSEquityByISIN 2 params → 200401404
GET
/mp/praams/analyse/equity/ticker/{ticker}
Analyse equity by ticker
AnalysePRAAMSEquityByTicker 2 params → 200401404
GET
/mp/praams/bank/balance_sheet/isin/{isin}
Get bank balance sheet by ISIN
GetPRAAMSBankBalanceSheetByISIN 2 params → 200401404
GET
/mp/praams/bank/balance_sheet/ticker/{ticker}
Get bank balance sheet by ticker
GetPRAAMSBankBalanceSheetByTicker 2 params → 200401404
GET
/mp/praams/bank/income_statement/isin/{isin}
Get bank income statement by ISIN
GetPRAAMSBankIncomeByISIN 2 params → 200401404
GET
/mp/praams/bank/income_statement/ticker/{ticker}
Get bank income statement by ticker
GetPRAAMSBankIncomeByTicker 2 params → 200401404
GET
/mp/praams/explore/bond
Explore bonds
ExplorePRAAMSBonds 7 params → 200401
GET
/mp/praams/explore/equity
Explore equities
ExplorePRAAMSEquities 7 params → 200401
GET
/mp/praams/reports/bond/{isin}
Get bond report by ISIN
GetPRAAMSBondReport 2 params → 200401404
GET
/mp/praams/reports/equity/isin/{isin}
Get equity report by ISIN
GetPRAAMSEquityReportByISIN 2 params → 200401404
GET
/mp/praams/reports/equity/ticker/{ticker}
Get equity report by ticker
GetPRAAMSEquityReportByTicker 2 params → 200401404
Options 3

Options contracts and pricing data

GET
/mp/unicornbay/options/contracts
Get options contracts
getOptionsContracts 17 params → 200401403404422429
GET
/mp/unicornbay/options/eod
Get end-of-day options data
getOptionsEOD 18 params → 200401403404422429
GET
/mp/unicornbay/options/underlying-symbols
List underlying symbols with options
listUnderlyingSymbols 3 params → 200401403404422429
Indices 2

S&P/Dow Jones indices data and components

GET
/mp/unicornbay/spglobal/comp/{symbol}
Index components (current + historical)
getIndexComponents 2 params → 200401403404429
GET
/mp/unicornbay/spglobal/list
List of indices with details
listIndicesWithDetails 1 param → 200401403429
Tick Data 2

Historical and marketplace tick-level trade data

GET
/mp/unicornbay/tickdata/ticks
Retrieve marketplace tick data
GetMarketplaceTickData 5 params → 200400401404
GET
/ticks
Retrieve historical tick data
GetTickData 5 params → 200400401404
News 3

Financial news and sentiment analysis

GET
/news
Retrieve financial news articles
GetFinancialNews 7 params → 200400401404
GET
/news-word-weights
Top weighted news keywords for a ticker
getNewsWordWeights 6 params → 200400401404429500
GET
/sentiments
Retrieve market news sentiment data
GetSentimentData 4 params → 200400401404
Interest Rates 3

Reference rates, central bank policy rates, and funding-stress spreads

GET
/rates/reference-rates
Get reference interest rates
GetReferenceRates 7 params → 200401403404422429
GET
/rates/policy-rates
Get central bank policy rates
GetPolicyRates 8 params → 200401403404422429
GET
/spreads/funding-stress
Get funding-stress spreads
GetFundingStressSpreads 4 params → 200401403404422429
Live (Delayed) Data 2

Delayed real-time stock prices and US delayed quotes

GET
/real-time/{ticker}
Retrieve delayed real-time stock prices
GetLiveDelayedStockPrices 4 params → 200400401404
GET
/us-quote-delayed
Get US delayed stock quotes
GetUSQuoteDelayed 3 params → 200400401
Sanctions 4

Sanctioned entities, vessels, programs, and sources (OFAC and others)

GET
/sanctions/entities
Get sanctioned entities
GetSanctionsEntities 9 params → 200401403404422429
GET
/sanctions/vessels
Get sanctioned vessels
GetSanctionsVessels 9 params → 200401403404422429
GET
/sanctions/programs
Get sanctions programs
GetSanctionsPrograms 1 param → 200401403404422429
GET
/sanctions/sources
Get sanctions sources
GetSanctionsSources 1 param → 200401403404422429
Screening 2

Stock screening tools

GET
/screener
Get filtered stock data based on user-defined criteria.
GetStockScreenerData 5 params → 200400401
GET
/search/{query}
Search stocks, companies, and ISINs
SearchStocksByQuery 6 params → 200400401404
Technical 1

Technical analysis indicators

GET
/technical/{ticker}
Retrieve technical indicator data for a specified symbol.
GetTechnicalIndicatorData 9 params → 200400401
US Treasury 4

US Treasury interest rates (bills, yields, long-term, real yields)

GET
/ust/bill-rates
Get US Treasury bill rates
GetUSTBillRates 6 params → 200401404
GET
/ust/long-term-rates
Get US Treasury long-term rates
GetUSTLongTermRates 6 params → 200401404
GET
/ust/real-yield-rates
Get US Treasury real yield curve rates
GetUSTRealYieldRates 6 params → 200401404
GET
/ust/yield-rates
Get US Treasury yield curve rates
GetUSTYieldRates 6 params → 200401404

Schemas 72

The contract defines 72 schemas that model the data the API accepts and returns. The most detailed are OptionsCommonAttributes (43 properties), IndexListItem (16 properties), InternalUser (13 properties), Resp_GetFundamentalData_200_application_json (13 properties). Each schema is shown below with its type and property counts.

Error
object
3 properties
InternalUser
object
13 properties 9 required
SearchResult
object
10 properties 6 required
WordWeightsResponse
object
3 properties 3 required
Links
object
1 property 1 required
MetaPagination
object
Pagination and field metadata.
5 properties 2 required
OptionsCommonAttributes
object
Common fields for options contract/EOD records. Values may be null.
43 properties
OptionsContractsItem
object
3 properties 3 required
OptionsEODItem
object
3 properties 3 required
OptionsContractsResponse
object
3 properties 3 required
OptionsEODResponse
object
3 properties 3 required
OptionsEODCompactResponse
object
3 properties 3 required
UnderlyingSymbolsResponse
object
3 properties 2 required
IndexListItem
object
16 properties 5 required
IndexListResponse
array
IndexGeneral
object
11 properties 4 required
IndexComponentItem
object
6 properties 3 required
IndexComponentsMap
object
HistoricalComponentItem
object
6 properties 5 required
HistoricalComponentsMap
object
IndexComponentsResponse
object
3 properties 3 required
Resp_GetTickerLogo_200_image_png
string
Resp_GetUpcomingEarnings_200_application_json
object
5 properties
Resp_GetUpcomingIPOs_200_application_json
object
5 properties
Resp_GetUpcomingSplits_200_application_json
object
5 properties
Resp_GetEarningsTrends_200_application_json
object
4 properties
Resp_GetHistoricalDividends_200_application_json
array
Resp_GetEconomicEventsData_200_application_json
array
Resp_GetEODDataByTicker_200_application_json
Resp_GetBulkEODData_200_application_json
Resp_GetExchangeDetails_200_application_json
object
13 properties
Resp_GetListOfExchanges_200_application_json
array
Resp_GetExchangeSymbolList_200_application_json
array
Resp_GetFundamentalData_200_application_json
object
13 properties
Resp_GetHistoricalMarketCap_200_application_json
object
1 property
Resp_GetInsiderTransactions_200_application_json
array
Resp_GetIntradayHistoricalData_200_application_json
array
Resp_GetMacroIndicatorData_200_application_json
array
Resp_getOptionsEOD_200_application_json
Resp_getIndexComponents_401_text_html
string
Resp_getIndexComponents_403_text_html
string
Resp_getIndexComponents_404_text_html
string
Resp_getIndexComponents_429_text_html
string
Resp_listIndicesWithDetails_401_text_html
string
Resp_listIndicesWithDetails_403_text_html
string
Resp_listIndicesWithDetails_429_text_html
string
Resp_GetFinancialNews_200_application_json
array
Resp_GetLiveDelayedStockPrices_200_application_json
Resp_GetStockScreenerData_200_application_json
object
1 property
Resp_SearchStocksByQuery_200_application_json
array
Resp_GetSentimentData_200_application_json
object
1 property
Resp_GetHistoricalSplits_200_application_json
array
Resp_GetSymbolChangeHistory_200_application_json
array
Resp_GetTechnicalIndicatorData_200_application_json
array
Resp_GetTickData_200_application_json
object
8 properties
FinancialStatementRow
object
Generic financial statement row. Contains a required 'date' plus arbitrary key-value pairs for line items.
1 property 1 required
IndexComponent
object
6 properties 3 required
HistoricalIndexComponent
object
6 properties 4 required
Resp_GetSovereignRiskPremium_200_application_json
object
3 properties 3 required
Resp_GetSovereignCreditRatings_200_application_json
object
3 properties 3 required
Resp_GetSovereignCdsSpreads_200_application_json
object
3 properties 3 required
Resp_GetSovereignDefaultSpreads_200_application_json
object
3 properties 3 required
Resp_GetCorporateCmdi_200_application_json
object
3 properties 3 required
Resp_GetCorporateHqmYields_200_application_json
object
3 properties 3 required
Resp_GetCdsMarketAggregates_200_application_json
object
3 properties 3 required
Resp_GetSanctionsEntities_200_application_json
object
3 properties 3 required
Resp_GetSanctionsVessels_200_application_json
object
3 properties 3 required
Resp_GetSanctionsPrograms_200_application_json
object
3 properties 3 required
Resp_GetSanctionsSources_200_application_json
object
3 properties 3 required
Resp_GetReferenceRates_200_application_json
object
3 properties 3 required
Resp_GetPolicyRates_200_application_json
object
3 properties 3 required
Resp_GetFundingStressSpreads_200_application_json
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

eodhd-financial-data-openapi.yml Raw ↑

Other APIs EODHD publishes across the network.

EODHD Intraday Historical Data API
EODHD Live (Delayed) Stock Prices API
EODHD WebSockets Real-Time API
EODHD Fundamental Data API
EODHD Stock Options API
EODHD Technical Indicators API
EODHD Economic Events Calendar API
EODHD Financial News and Sentiment API
EODHD Exchanges and Symbols API
EODHD Eod API