> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# EODHD APIs

> EODHD APIs provide comprehensive financial data, including historical stock market data, live stock prices, fundamental data, and more, accessible via REST and WebSocket APIs.

![EODHD APIs logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/eodhd_apis.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=cb3fac49d799919395009bcc4578867d)

* **Category:** market data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 11
* **Triggers:** 0
* **Slug:** `EODHD_APIS`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Get EOD Yahoo Style Data
>
> **Slug:** `EODHD_APIS_GET_EOD_YAHOO_STYLE`
>
> Retrieves end-of-day historical stock price data using Yahoo Finance style parameters via EODHD API. Returns OHLCV (Open, High, Low, Close, Volume) data plus adjusted close prices for stocks, ETFs, mutual funds, bonds, and other securities across 70+ global exchanges. Use this alternative API when you need Yahoo Finance compatible date parameters (a/b/c for start date, d/e/f for end date with 0-indexed months).
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.003 per 100 EOD history requests
>
> #### Input Parameters
>
> **a** `string` *required*
>
> Start month in Yahoo Finance format (0-11, where 0=January, 11=December). For example, use '00' for January, '05' for June, '11' for December.
>
> **b** `string` *required*
>
> Start day of month (01-31). Use two-digit format with leading zero if needed (e.g., '01', '05', '15', '31').
>
> **c** `string` *required*
>
> Start year in YYYY format (e.g., '2017', '2020', '2024').
>
> **d** `string` *required*
>
> End month in Yahoo Finance format (0-11, where 0=January, 11=December). For example, use '00' for January, '05' for June, '11' for December.
>
> **e** `string` *required*
>
> End day of month (01-31). Use two-digit format with leading zero if needed (e.g., '01', '05', '15', '31').
>
> **f** `string` *required*
>
> End year in YYYY format (e.g., '2017', '2020', '2024').
>
> **g** `string ("d" | "w" | "m")` *required*
>
> Data period/frequency. 'd' for daily (default), 'w' for weekly, 'm' for monthly. Weekly data shows data for Fridays; monthly data shows end-of-month values.
>
> **s** `string` *required*
>
> Stock symbol with exchange suffix in format 'TICKER.EXCHANGE' (e.g., 'MCD.US' for McDonald's on US exchanges, 'AAPL.US' for Apple, 'BP.LSE' for BP on London Stock Exchange).
>
> **fmt** `string`
>
> Output format for the response. Note: The Yahoo Finance style endpoint only supports CSV format internally. This parameter is kept for API compatibility but is not sent to the server. The action will always parse CSV and return JSON.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Financial News
>
> **Slug:** `EODHD_APIS_GET_FINANCIAL_NEWS`
>
> Retrieve EODHD financial-news articles by ticker, topic, date, and page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of articles to return (1-1000).
>
> **topic** `string`
>
> News topic tag, such as technology or earnings report.
>
> **offset** `integer`
>
> Number of articles to skip. Offset plus limit cannot exceed 10000.
>
> **symbol** `string`
>
> Ticker with exchange code, such as AAPL.US.
>
> **to\_date** `string`
>
> Inclusive end date in YYYY-MM-DD format.
>
> **direction** `integer ("0" | "1")`
>
> Sort order: 0 returns newest articles first; 1 pages forward in database order.
>
> **from\_date** `string`
>
> Inclusive start date in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get ID Mapping
>
> **Slug:** `EODHD_APIS_GET_ID_MAPPING`
>
> Tool to convert between different security identifiers (CUSIP, ISIN, FIGI, LEI, CIK, ticker symbol). Use when you need to map one type of identifier to another, normalize portfolio data, or cross-reference securities across different systems. At least one filter parameter must be provided.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.003 per 100 ID-mapping requests
>
> #### Input Parameters
>
> **fmt** `string`
>
> Output format. Use 'json' for JSON response.
>
> **filter\_ex** `string`
>
> Filter by exchange code (e.g., 'US', 'LSE', 'XETRA'). Use this to get all symbols from a specific exchange.
>
> **filter\_cik** `string`
>
> Filter by CIK (Central Index Key) identifier used by the SEC. Use this to find securities associated with a specific SEC filer.
>
> **filter\_lei** `string`
>
> Filter by LEI (Legal Entity Identifier). Use this to find securities associated with a specific legal entity.
>
> **page\_limit** `integer`
>
> Maximum number of results to return per page. Default is 1000.
>
> **filter\_figi** `string`
>
> Filter by FIGI (Financial Instrument Global Identifier). Use this to find the ticker symbol and other identifiers for a given FIGI.
>
> **filter\_isin** `string`
>
> Filter by ISIN (International Securities Identification Number) identifier. Use this to find the ticker symbol and other identifiers for a given ISIN.
>
> **page\_offset** `integer`
>
> Number of results to skip for pagination. Use this to retrieve subsequent pages of results.
>
> **filter\_cusip** `string`
>
> Filter by CUSIP (Committee on Uniform Securities Identification Procedures) identifier. Use this to find the ticker symbol and other identifiers for a given CUSIP.
>
> **filter\_symbol** `string`
>
> Filter by ticker symbol in 'TICKER.EXCHANGE' format (e.g., 'AAPL.US'). Use this to find other identifiers for a given ticker symbol.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Macro Indicators
>
> **Slug:** `EODHD_APIS_GET_MACRO_INDICATORS`
>
> Retrieve macroeconomic indicator data for a specific country from EODHD. Returns historical time series data for economic indicators like GDP, inflation, unemployment, population, and many more. Data typically spans from 1960 to the present year. Use this when you need economic statistics for analysis, comparison, or research.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.003 per 10 macro-indicator requests
>
> #### Input Parameters
>
> **country** `string` *required*
>
> ISO 3166-1 alpha-3 country code (3 letters) for which to retrieve indicators. Examples: 'USA' (United States), 'GBR' (United Kingdom), 'DEU' (Germany), 'FRA' (France), 'JPN' (Japan), 'CHN' (China), 'IND' (India), 'BRA' (Brazil), 'CAN' (Canada), 'AUS' (Australia).
>
> **indicator** `string`
>
> Macroeconomic indicator code to retrieve. Available indicators include: 'gdp\_current\_usd' (GDP in current USD, default), 'gdp\_per\_capita\_usd' (GDP per capita), 'real\_gdp\_per\_capita' (Real GDP per capita), 'gdp\_growth\_annual' (Annual GDP growth %), 'inflation\_consumer\_prices\_annual' (Consumer price inflation %), 'unemployment\_total\_percent' (Unemployment rate %), 'population\_total' (Total population), 'life\_expectancy' (Life expectancy at birth), 'gni\_current\_usd' (Gross National Income), 'exports\_of\_goods\_services\_percent\_gdp' (Exports % of GDP), 'imports\_of\_goods\_services\_percent\_gdp' (Imports % of GDP), 'real\_interest\_rate' (Real interest rate %), 'central\_government\_debt\_percent\_gdp' (Government debt % of GDP), 'net\_migration' (Net migration), and many more.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Mutual Funds Data
>
> **Slug:** `EODHD_APIS_GET_MUTUAL_FUNDS_DATA`
>
> Retrieve mutual fund fundamentals by ticker or identifier, optionally filtering sections. Unfiltered responses retain general information and the MutualFund field; filtered responses return the selected data as a raw response.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.003 per 10 mutual-fund fundamentals requests
>
> #### Input Parameters
>
> **filter** `string`
>
> Optional filter to retrieve specific sections of the data. Examples: 'General', 'MutualFund', 'MutualFund::Asset\_Allocation'. Leave empty to get full fundamental data.
>
> **ticker** `string` *required*
>
> Mutual fund ticker symbol in 'TICKER.EXCHANGE' format. Examples: 'VFIAX.US' (Vanguard 500 Index Fund Admiral), 'SWPPX.US' (Schwab S\&P 500 Index Fund). You can also use ISIN/CUSIP identifiers (e.g., 'US8085098551').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Real-Time Quote
>
> **Slug:** `EODHD_APIS_GET_REAL_TIME_QUOTE`
>
> Retrieve live or delayed OHLCV quotes for stocks, forex, and cryptocurrencies, including previous close and price changes. A request can include additional symbols.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.003 per 100 requested quote symbols
>
> #### Input Parameters
>
> **s** `string`
>
> Additional ticker symbols comma-separated (max 15-20 recommended). Example: 'TSLA.US,MSFT.US,GOOGL.US'. When provided, returns data for multiple symbols in a single request.
>
> **fmt** `string ("json" | "csv")`
>
> Output format for the API response
>
> **symbol** `string` *required*
>
> Primary ticker symbol with exchange code (e.g., 'AAPL.US' for Apple stock, 'EURUSD.FOREX' for EUR/USD forex pair, 'BTC-USD.CC' for Bitcoin). Format is 'TICKER.EXCHANGE'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Real-Time FOREX WebSocket Stream
>
> **Slug:** `EODHD_APIS_GET_REAL_TIME_WEBSOCKET_FOREX`
>
> Provides WebSocket connection details for real-time FOREX currency pair data from EODHD. Returns the WebSocket endpoint URL and subscription message needed to receive live bid/ask prices with \~50ms latency for forex pairs like EURUSD, GBPUSD, USDJPY. Response data format from the WebSocket includes: - s: symbol (e.g., 'EURUSD') - a: ask price - b: bid price - dc: daily change percentage - dd: daily difference - t: timestamp in epoch milliseconds Note: Maximum 50 symbols can be subscribed at once.
>
> #### Input Parameters
>
> **symbols** `array` *required*
>
> List of FOREX currency pair symbols in concatenated format without separator (e.g., 'EURUSD', 'GBPUSD', 'USDJPY'). Each symbol should be 6 characters: 3-letter base currency followed by 3-letter quote currency. Maximum 50 symbols allowed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Real-time WebSocket US Trades
>
> **Slug:** `EODHD_APIS_GET_REAL_TIME_WEBSOCKET_US_TRADE`
>
> Generate a WebSocket URL and subscribe or unsubscribe payload for real-time US market trades on specified symbols. Connect to the returned URL and send the payload to receive updates.
>
> #### Input Parameters
>
> **action** `string ("subscribe" | "unsubscribe")` *required*
>
> Action to perform: 'subscribe' to start receiving real-time trade updates, or 'unsubscribe' to stop receiving updates for the specified symbols.
>
> **symbols** `array` *required*
>
> List of US stock ticker symbols (e.g., \['AAPL', 'TSLA', 'MSFT']). Maximum 50 symbols per connection. Demo API keys support limited tickers: AAPL, TSLA, VTI, AMZN.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Info
>
> **Slug:** `EODHD_APIS_GET_USER_INFO`
>
> Retrieve current user account information and API usage statistics from EODHD. Returns details including subscription type, daily rate limits, number of API requests made, email, name, and payment method. Use this to monitor API usage, check remaining quota, or verify account details.
>
> #### Input Parameters
>
> **fmt** `string`
>
> Output format. Use 'json' for JSON response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get US Treasury Yield Rates
>
> **Slug:** `EODHD_APIS_GET_UST_YIELD_RATES`
>
> Retrieve historical US Treasury par yield curve rates from EODHD across maturities from one month to 30 years. Use the data to analyze the yield curve for financial or economic research; optional date and year filters can narrow the request.
>
> #### Input Parameters
>
> **to** `string`
>
> End date for filtering yield rates in YYYY-MM-DD format. Returns rates up to this date.
>
> **from** `string`
>
> Start date for filtering yield rates in YYYY-MM-DD format. Returns rates from this date onwards.
>
> **limit** `integer`
>
> Maximum number of yield rate records to return. Use this to limit the response size when querying large date ranges.
>
> **offset** `integer`
>
> Number of records to skip before returning results. Use together with 'limit' for pagination through large result sets.
>
> **filter\_year** `integer`
>
> Filter data by year (e.g., 2023, 2024). Valid range: 1900 to current year + 1. Defaults to current year if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Supported Exchanges
>
> **Slug:** `EODHD_APIS_LIST_EXCHANGES`
>
> Retrieve a list of all supported stock exchanges from EODHD API. Returns exchange codes, names, countries, and currencies for 70+ global exchanges. Use this when you need to discover available exchanges or verify exchange codes for ticker symbols.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.003 per 100 exchange-list requests
>
> #### Input Parameters
>
> **fmt** `string ("json" | "csv")`
>
> Output format for the exchanges list response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Screen Stocks
>
> **Slug:** `EODHD_APIS_SCREEN_STOCKS`
>
> Filter, sort, and page through stocks covered by EODHD.
>
> #### Input Parameters
>
> **sort** `string`
>
> Filterable field followed by asc or desc, such as market\_capitalization.desc.
>
> **limit** `integer`
>
> Maximum number of securities to return.
>
> **offset** `integer`
>
> Number of matching securities to skip.
>
> **filters** `array`
>
> Filter triples \[field, operation, value], combined with AND. String fields support =, match, in, and not in; numeric fields support =, !=, >, \<, >=, \<=, in, and not in. The in operations require an array value.
>
> **signals** `array`
>
> Pre-calculated signals that every returned security must satisfy.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Instruments
>
> **Slug:** `EODHD_APIS_SEARCH_INSTRUMENTS`
>
> Search for stocks, ETFs, mutual funds, bonds, and indices by ticker symbol, company name, or ISIN. Use when you need to find instruments by name or identifier, discover available tickers, or look up securities across exchanges. The API searches among active tickers only.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.003 per 100 search requests
>
> #### Input Parameters
>
> **type** `string`
>
> Filter results by instrument type. Available types: 'stock', 'fund', 'etf', 'bond', 'index'. Leave empty to search all types.
>
> **limit** `integer`
>
> Maximum number of results to return. If not specified, API returns all matching results.
>
> **query** `string` *required*
>
> Search query to find instruments by ticker symbol, company name, or ISIN. Examples: 'AAPL' (Apple ticker), 'Apple Inc' (company name), 'US0378331005' (ISIN).
>
> **exchange** `string`
>
> Filter results by exchange code. Examples: 'US' (United States), 'LSE' (London Stock Exchange), 'TO' (Toronto). Leave empty to search all exchanges.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
