# 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.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `EODHD_APIS`
- **Version:** 20260313_00

## Tools

### 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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `a` | string | Yes | 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 | Yes | Start day of month (01-31). Use two-digit format with leading zero if needed (e.g., '01', '05', '15', '31'). |
| `c` | string | Yes | Start year in YYYY format (e.g., '2017', '2020', '2024'). |
| `d` | string | Yes | 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 | Yes | End day of month (01-31). Use two-digit format with leading zero if needed (e.g., '01', '05', '15', '31'). |
| `f` | string | Yes | End year in YYYY format (e.g., '2017', '2020', '2024'). |
| `g` | string ("d" | "w" | "m") | Yes | 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 | Yes | 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 | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fmt` | string | No | Output format. Use 'json' for JSON response. |
| `filter_ex` | string | No | Filter by exchange code (e.g., 'US', 'LSE', 'XETRA'). Use this to get all symbols from a specific exchange. |
| `filter_cik` | string | No | 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 | No | Filter by LEI (Legal Entity Identifier). Use this to find securities associated with a specific legal entity. |
| `page_limit` | integer | No | Maximum number of results to return per page. Default is 1000. |
| `filter_figi` | string | No | Filter by FIGI (Financial Instrument Global Identifier). Use this to find the ticker symbol and other identifiers for a given FIGI. |
| `filter_isin` | string | No | 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 | No | Number of results to skip for pagination. Use this to retrieve subsequent pages of results. |
| `filter_cusip` | string | No | 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 | No | Filter by ticker symbol in 'TICKER.EXCHANGE' format (e.g., 'AAPL.US'). Use this to find other identifiers for a given ticker symbol. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `country` | string | Yes | 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 | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Mutual Funds Data

**Slug:** `EODHD_APIS_GET_MUTUAL_FUNDS_DATA`

Retrieves comprehensive fundamental data for mutual funds via EODHD API. Returns fund details including general information (name, family, inception date, summary), asset allocation (cash, stocks, bonds percentages), value/growth measures (P/E, price-to-book), sector weightings, and world regions exposure. Supports over 20,000 US mutual funds including equity, balanced, and bond-based funds. Use ticker format 'SYMBOL.US' (e.g., 'VFIAX.US', 'SWPPX.US') or ISIN/CUSIP identifiers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | Optional filter to retrieve specific sections of the data. Examples: 'General', 'MutualFund', 'MutualFund::Asset_Allocation'. Leave empty to get full fundamental data. |
| `ticker` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Real-Time Quote

**Slug:** `EODHD_APIS_GET_REAL_TIME_QUOTE`

Retrieves real-time (delayed 15-20 minutes for stocks, ~1 minute for forex) OHLCV data for stocks, forex, and cryptocurrencies. Returns latest 1-minute bar with open, high, low, close, volume, previous close, and price changes. Use this when you need current market prices and intraday data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `s` | string | No | 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") | No | Output format for the API response |
| `symbol` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbols` | array | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Real-time WebSocket US Trades

**Slug:** `EODHD_APIS_GET_REAL_TIME_WEBSOCKET_US_TRADE`

Tool to retrieve real-time trade data for the US market via WebSocket. Use when live updates for specific US symbols are required. Example: subscribe to ['AAPL', 'GOOG'].

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string ("subscribe" | "unsubscribe") | Yes | Action to perform: 'subscribe' to start receiving real-time trade updates, or 'unsubscribe' to stop receiving updates for the specified symbols. |
| `symbols` | array | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fmt` | string | No | Output format. Use 'json' for JSON response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get US Treasury Yield Rates

**Slug:** `EODHD_APIS_GET_UST_YIELD_RATES`

Retrieve US Treasury yield curve rates from EODHD API. Returns historical par yield data across all maturities (1 month, 6 months, 1 year, 2 years, 5 years, 10 years, 30 years, etc.). Use this when you need Treasury yield curve data for financial analysis, economic research, or investment decisions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End date for filtering yield rates in YYYY-MM-DD format. Returns rates up to this date. |
| `from` | string | No | Start date for filtering yield rates in YYYY-MM-DD format. Returns rates from this date onwards. |
| `filter_year` | integer | No | Filter data by year (e.g., 2023, 2024). Valid range: 1900 to current year + 1. Defaults to current year if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fmt` | string ("json" | "csv") | No | Output format for the exchanges list response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter results by instrument type. Available types: 'stock', 'fund', 'etf', 'bond', 'index'. Leave empty to search all types. |
| `limit` | integer | No | Maximum number of results to return. If not specified, API returns all matching results. |
| `query` | string | Yes | Search query to find instruments by ticker symbol, company name, or ISIN. Examples: 'AAPL' (Apple ticker), 'Apple Inc' (company name), 'US0378331005' (ISIN). |
| `exchange` | string | No | Filter results by exchange code. Examples: 'US' (United States), 'LSE' (London Stock Exchange), 'TO' (Toronto). Leave empty to search all exchanges. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |