The EODHD MCP connector routes your AI agent's tool calls to EODHD's own MCP server through Scalekit. Each user signs in to EODHD once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 91 tools.
- Tools
- 91
- What they doRead · write · destructive
- 86 · 5 · 086 read5 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the EODHD MCP connection
In AgentKit > Connections, create an EODHD MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for EODHD MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'eodhdmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize EODHD MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'eodhdmcp_get_asx_corporate_actions',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "eodhdmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize EODHD MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="eodhdmcp_get_asx_corporate_actions",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_tooleodhdmcp_get_asx_corporate_actionsGet structured corporate action data for ASX (Australian Securities Exchange) listed securities: dividends, splits, bonus issues, rights issues, buybacks, capital returns, and share purchase plans.Read-onlyGet Asx Corporate Actions
Get structured corporate action data for ASX (Australian Securities Exchange) listed securities: dividends, splits, bonus issues, rights issues, buybacks, capital returns, and share purchase plans. Data is sourced from the official ASX ReferencePoint (E34) feed and refreshed daily. Coverage is limited to ASX-listed tickers (all use the .AU suffix). Costs 1 API call per request. Use when the user asks about Australian dividends and franking credits, ASX splits, bonus/rights issues, buybacks, capital returns, or share purchase plans. For corporate actions on other exchanges use get_historical_dividends / get_historical_splits.
Inputs
action_typestring- Corporate action category. One of: 'dividends', 'splits', 'bonus-issues', 'rights-issues', 'buybacks', 'capital-returns', 'spp', 'other'. Omit to return all types.
api_tokenstring- Per-call token override.
end_datestring- 'date_to' in YYYY-MM-DD (inclusive, on event date).
fmtstring- 'json' only.default
json limitinteger- Page size, 1..1000. Default 100.default
100 offsetinteger- Zero-based pagination offset. Default 0.default
0 start_datestring- 'date_from' in YYYY-MM-DD (inclusive, on event date).
symbolstring- Ticker with .AU suffix (e.g. 'PMV.AU'). Filters to a single security.
eodhdmcp_get_bulk_fundamentalsFetch fundamental data for all stocks on an exchange in bulk.Read-onlyGet Bulk Fundamentals
Fetch fundamental data for all stocks on an exchange in bulk. Use when the user needs financials, valuation, or earnings data for many companies at once -- screening, comparing sectors, or building dashboards across an entire exchange. Returns General, Highlights, Valuation, Technicals, SplitsDividends, Earnings (last 4 quarters + 4 years), and Financials for up to 500 stocks per call. Stocks only (no ETFs or mutual funds). Costs 100 API calls per request. Requires Extended Fundamentals plan. For a single ticker's full fundamentals, use get_fundamentals_data instead. For macro country-level economic data, use get_macro_indicator.
Inputs
exchangestringrequired- Exchange code (e.g., 'NASDAQ', 'NYSE', 'US', 'LSE').
api_tokenstring- Per-call token override.
fmtstring- 'json' (default) or 'csv'.default
json limitstring- Max symbols to return (default 500, max 500).
offsetstring- Pagination start (default 0).
symbolsstring- Comma-separated list of specific symbols to filter.
versionstring- '1.2' for single-symbol-like output format.
eodhdmcp_get_cboe_index_dataFetch detailed data for a specific CBOE index on a given date, including all constituent components.Read-onlyGet Cboe Index Data
Fetch detailed data for a specific CBOE index on a given date, including all constituent components. Use when the user needs index close value, divisor, and full component breakdown (symbols, weights, market caps, sectors) for a CBOE index. Requires index_code, feed_type, and date. Returns index-level attributes plus an array of components with ISIN, closing price, currency, shares, market cap, weighting, and sector. Costs 10 API calls per request. For listing all available CBOE indices, use get_cboe_indices_list first.
Inputs
datestringrequired- Trading date in YYYY-MM-DD format.
feed_typestringrequired- Feed type (e.g., 'snapshot_official_closing').
index_codestringrequired- CBOE index code (e.g., 'BDE30P', 'BAT20N').
api_tokenstring- Per-call token override.
fmtstring- 'json' only (default).default
json
eodhdmcp_get_cboe_indices_listList all available CBOE indices with their latest values.Read-onlyGet Cboe Indices List
List all available CBOE indices with their latest values. Use when the user wants to browse CBOE European and regional index families, check which CBOE indices are available, or find a CBOE index code. Returns index codes, regions, latest close values, index divisors, and feed metadata for ~38 CBOE indices. Paginated via 'links.next'. Costs 10 API calls per request. For detailed component-level data on a specific CBOE index, use get_cboe_index_data. Returns: Object with: - meta (object): total (int) â total number of indices - data (array): index objects, each with: - id (str): CBOE index identifier - type (str): always "cboe-index" - attributes (object): - region (str): geographic region (e.g. "Eurozone", "Germany") - index_code (str): CBOE index code - feed_type (str): feed type (e.g. "snapshot_official_closing") - date (str): latest date (YYYY-MM-DD) - index_close (float): latest closing value - index_divisor (float): index divisor - links (object): next (str|null) â URL for next page, null if last Notes: - Pagination: If 'links.next' is not null, call that URL to get the next page. - Rate limits: * 10 API calls per request (CBOE dataset rule of thumb). Examples: "List all CBOE indices" â get_cboe_indices_list() "What CBOE European indices are available?" â get_cboe_indices_list()
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_get_company_newsFetch financial news articles for a stock ticker or topic tag within a date range.Read-onlyGet Company News
Fetch financial news articles for a stock ticker or topic tag within a date range. Returns full article objects with title, content, URL, date, and related tickers. Use when the user asks for news headlines, recent articles, or press coverage about a company or sector. For aggregated sentiment scores derived from news, use get_sentiment_data instead. For keyword frequency analysis in news, use get_news_word_weights instead.
Inputs
api_tokenstring- Per-call token override; env token used if omitted.
end_datestring- YYYY-MM-DD. Mapped to 'to'.
fmtstring- 'json' or 'xml' (default 'json').default
json limitinteger- 1..1000 (default 50).default
50 offsetinteger- >= 0 (default 0).default
0 start_datestring- YYYY-MM-DD. Mapped to 'from'.
tagstring- Topic tag (e.g., 'technology'). Mapped to 't'.
tickerstring- SYMBOL.EXCHANGE_ID (e.g., 'AAPL.US'). Mapped to 's'.
eodhdmcp_get_congressional_tradesFetch US Congress securities transactions disclosed under the STOCK Act.Read-onlyGet Congressional Trades
Fetch US Congress securities transactions disclosed under the STOCK Act. Filters cover ticker, chamber, member Bioguide ID, transaction type, transaction/disclosure date ranges, and upstream pagination. A trailing ``.US`` ticker suffix is accepted and removed, while class-share dots such as ``BRK.B`` are preserved. Costs 10 API calls and requires All-in-One. Returns the upstream JSON envelope unchanged: ``data`` contains nested member, asset, transaction, and source objects; ``meta`` contains total and page details; and ``links.next`` points to the next page when present.
Inputs
api_tokenstring- Per-call token override. If omitted, env token is used.
bioguide_idstring- Filter by member Bioguide ID.
chamberstring- Filter by chamber of Congress: 'house' or 'senate'.
disclosure_date_fromstring- Start of disclosure date range filter (YYYY-MM-DD).
disclosure_date_tostring- End of disclosure date range filter (YYYY-MM-DD).
limitstring- Records per page.
offsetstring- Pagination offset.
symbolstring- Filter by ticker symbol (e.g. 'AAPL' or 'AAPL.US'; trailing .US is stripped, class-share dots like BRK.B are preserved).
transaction_date_fromstring- Start of transaction date range filter (YYYY-MM-DD).
transaction_date_tostring- End of transaction date range filter (YYYY-MM-DD).
transaction_typestring- Filter by transaction type (e.g. 'purchase', 'sale').
eodhdmcp_get_credit_cds_market_aggregatesFetch aggregated CDS market statistics.Read-onlyGet Credit Cds Market Aggregates
Fetch aggregated CDS market statistics. Use when the user asks about CDS market gross notional, CDS activity broken down by grade or cleared status, or CDS market size over time. Returns aggregated CDS market metrics (e.g. gross notional) broken down by a chosen dimension (grade or cleared status). Filterable by metric, dimension, and date range. Paginated.
Inputs
api_tokenstring- Per-call token override.
date_fromstring- Start date filter (YYYY-MM-DD).
date_tostring- End date filter (YYYY-MM-DD).
dimensionstring- Breakdown dimension: 'grade' or 'cleared_status'.
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
metricstring- Metric to aggregate. Currently 'gross_notional'.
offsetstring- Pagination offset.
eodhdmcp_get_credit_corporate_cmdiFetch the Corporate Market-based Default Indicator (CMDI) time series.Read-onlyGet Credit Corporate Cmdi
Fetch the Corporate Market-based Default Indicator (CMDI) time series. Use when the user asks about corporate credit stress, the CMDI index, or investment-grade vs high-yield market default indicators. Returns the market CMDI along with investment-grade (IG) and high-yield (HY) sub-indices over time. Filterable by date range. Paginated.
Inputs
api_tokenstring- Per-call token override.
date_fromstring- Start date filter (YYYY-MM-DD).
date_tostring- End date filter (YYYY-MM-DD).
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
eodhdmcp_get_credit_corporate_hqm_yieldsFetch HQM (High Quality Market) corporate bond yield curves.Read-onlyGet Credit Corporate Hqm Yields
Fetch HQM (High Quality Market) corporate bond yield curves. Use when the user asks about HQM corporate yields, high-quality corporate bond spot or par yields, or yields by tenor. Returns HQM corporate bond yields by tenor (in years) and yield type (par or spot) over time. Filterable by tenor, type, and date range. Paginated.
Inputs
api_tokenstring- Per-call token override.
date_fromstring- Start date filter (YYYY-MM-DD).
date_tostring- End date filter (YYYY-MM-DD).
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
tenorstring- Tenor in years. One of 1, 2, 3, 5, 7, 10, 15, 20, 25, 30.
typestring- Yield type: 'par' or 'spot'.
eodhdmcp_get_credit_sovereign_cds_spreadsFetch sovereign CDS (credit default swap) spreads by country.Read-onlyGet Credit Sovereign Cds Spreads
Fetch sovereign CDS (credit default swap) spreads by country. Use when the user asks about sovereign CDS spreads, default insurance costs for government debt, or CDS net of the Switzerland benchmark. Returns sovereign CDS spreads (raw and net of Switzerland) with Moody's rating context. Filterable by country and as-of date. Paginated.
Inputs
api_tokenstring- Per-call token override.
as_ofstring- Filter by as-of date (YYYY-MM-DD).
countrystring- Filter by country (ISO-3 code or name).
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
eodhdmcp_get_credit_sovereign_credit_ratingsFetch sovereign credit ratings from the three major agencies.Read-onlyGet Credit Sovereign Credit Ratings
Fetch sovereign credit ratings from the three major agencies. Use when the user asks about a country's credit rating, Moody's / S&P / Fitch sovereign ratings, or ratings comparisons across countries. Returns Moody's, S&P, and Fitch sovereign ratings by country. Filterable by country and as-of date. Paginated.
Inputs
api_tokenstring- Per-call token override.
as_ofstring- Filter by as-of date (YYYY-MM-DD).
countrystring- Filter by country (ISO-3 code or name).
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
eodhdmcp_get_credit_sovereign_default_spreadsFetch default spreads by credit rating.Read-onlyGet Credit Sovereign Default Spreads
Fetch default spreads by credit rating. Use when the user asks about the default spread associated with a given rating (e.g. Aaa, Baa2), or the rating-to-spread mapping used to derive country risk premiums. Returns the default spread for each rating bucket. Filterable by rating and as-of date. Paginated.
Inputs
api_tokenstring- Per-call token override.
as_ofstring- Filter by as-of date (YYYY-MM-DD).
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
ratingstring- Filter by rating (e.g. 'Aaa', 'Baa2').
eodhdmcp_get_earnings_trendsGet earnings trend data including EPS/revenue estimates, analyst revisions, and growth projections for specific stocks.Read-onlyGet Earnings Trends
Get earnings trend data including EPS/revenue estimates, analyst revisions, and growth projections for specific stocks. Returns quarterly and annual consensus estimates, number of analysts, and revision history. Requires explicit symbol(s). Each request consumes ~10 API calls. Use when the user asks about earnings expectations, analyst estimate changes, or EPS growth trends. For earnings report dates and calendar, use get_upcoming_earnings instead. Returns: Array of trend records, each with: - code (str): ticker symbol - date (str): report date - period (str): fiscal period (e.g. '+1y', '0q') - growth (float|null): expected growth rate - earningsEstimate (object): avg, low, high, yearAgoEps, numberOfAnalysts, growth - revenueEstimate (object): avg, low, high, yearAgoRevenue, numberOfAnalysts, growth - epsTrend (object): current, 7daysAgo, 30daysAgo, 60daysAgo, 90daysAgo - epsRevisions (object): upLast7days, upLast30days, downLast7days, downLast30days Examples: "Apple earnings trend" â symbols="AAPL.US" "Compare Tesla and Nvidia earnings trends" â symbols="TSLA.US,NVDA.US" Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
symbolsstringrequired- No description.
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_get_economic_eventsFetch macroeconomic calendar events such as GDP, CPI, employment, and interest rate releases.Read-onlyGet Economic Events
Fetch macroeconomic calendar events such as GDP, CPI, employment, and interest rate releases. Returns scheduled and past economic indicators with actual, estimate, and previous values. Covers global economies; filter by country (ISO-2), date range, comparison period (mom/qoq/yoy), and event type. Use when the user asks about economic calendar, macro releases, or upcoming government data publications. This tool covers macro events only -- for company-level earnings dates, use get_upcoming_earnings. Returns: Array of events, each with: - type (str): event category - country (str): ISO-3166 alpha-2 country code - date (str): event datetime - actual (float|null): actual value - previous (float|null): previous period value - estimate (float|null): consensus estimate - change (float|null): absolute change - changePercentage (float|null): percentage change - event (str): event name/description Examples: "US economic events this week" â country="US", start_date="2026-03-02", end_date="2026-03-06" "German GDP year-over-year" â country="DE", comparison="yoy", type="GDP" "All events in March 2026, first 200" â start_date="2026-03-01", end_date="2026-03-31", limit=200 Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
api_tokenstring- No description.
comparisonstring- No description.
countrystring- No description.
end_datestring- No description.
fmtstring- No description.default
json limitinteger- No description.default
50 offsetinteger- No description.default
0 start_datestring- No description.
typestring- No description.
eodhdmcp_get_exchange_detailsRetrieve detailed metadata for a single exchange: trading hours, timezone, open/closed status, holidays, and ticker counts.Read-onlyGet Exchange Details
Retrieve detailed metadata for a single exchange: trading hours, timezone, open/closed status, holidays, and ticker counts. Use when the user asks about exchange schedules, market holidays, or whether an exchange is currently open. Returns timezone, isOpen flag, trading hours (open/close with UTC equivalents, working days, lunch breaks), exchange holidays (bank and official, ~6 months window), and ticker statistics (active, updated today, previous day). For the list of all exchanges, use get_exchanges_list. For tickers on an exchange, use get_exchange_tickers.
Inputs
exchange_codestringrequired- Exchange code (e.g., 'US', 'LSE', 'XETRA').
api_tokenstring- Per-call token override (env token otherwise).
end_datestring- YYYY-MM-DD; filter holidays up to this date.
fmtstring- 'json' only (default).default
json start_datestring- YYYY-MM-DD; filter holidays from this date.
eodhdmcp_get_exchange_tickersList all tickers (symbols) available on a given exchange.Read-onlyGet Exchange Tickers
List all tickers (symbols) available on a given exchange. Use when the user needs to enumerate stocks, ETFs, or funds on an exchange, or check if a specific instrument is listed there. Covers common stocks, preferred stocks, ETFs, and funds. By default returns tickers active in the last month. Supports delisted tickers via the delisted flag. For US markets, use 'US' (unified) or specific venues like NYSE, NASDAQ. For the list of all exchanges, use get_exchanges_list. For exchange metadata and trading hours, use get_exchange_details. Returns: Array of ticker objects, each with: - Code (str): ticker symbol - Name (str): instrument name - Country (str): country of listing - Exchange (str): exchange code - Currency (str): trading currency - Type (str): instrument type (e.g. "Common Stock", "ETF") - Isin (str|null): ISIN code, if available Examples: "All tickers on London Stock Exchange" â get_exchange_tickers(exchange_code="LSE") "Show me delisted US stocks" â get_exchange_tickers(exchange_code="US", delisted=True) "ETFs trading on XETRA" â get_exchange_tickers(exchange_code="XETRA", type="etf")
Inputs
exchange_codestringrequired- No description.
api_tokenstring- No description.
delistedstring- No description.
fmtstring- No description.default
json typestring- No description.
eodhdmcp_get_exchanges_listList all available stock exchanges worldwide.Read-onlyGet Exchanges List
List all available stock exchanges worldwide. Use when the user asks which exchanges are supported, needs exchange codes, or wants to browse markets by country. Covers 60+ global exchanges. Returns Name, Code, OperatingMIC, Country, Currency, and ISO country codes for each exchange. For tickers listed on a specific exchange, use get_exchange_tickers. For trading hours, holidays, and metadata of one exchange, use get_exchange_details. Returns: Array of exchange objects, each with: - Name (str): exchange full name - Code (str): exchange code (e.g. "US", "LSE") - OperatingMIC (str): ISO 10383 operating MIC - Country (str): country name - Currency (str): primary currency code - CountryISO2 (str): ISO 3166-1 alpha-2 country code - CountryISO3 (str): ISO 3166-1 alpha-3 country code Examples: "List all available exchanges" â get_exchanges_list() "What stock exchanges does EODHD support?" â get_exchanges_list()
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_get_fundamentals_dataRetrieve fundamental data for a single stock, ETF, mutual fund, index, or crypto.Read-onlyGet Fundamentals Data
Retrieve fundamental data for a single stock, ETF, mutual fund, index, or crypto. Auto-detects asset type. For stocks: returns financials (income statement, balance sheet, cash flow), earnings, valuation, analyst ratings, holders, insider transactions, and outstanding shares. For ETFs: returns holdings, asset allocation, sector/country weights. For mutual funds: fund-specific data. Supports date-range pruning to limit financials and earnings to a specific window. For bulk fundamentals across many tickers at once, use get_bulk_fundamentals instead. For price data, use get_historical_stock_prices or get_live_price_data instead. Returns: Nested object; structure depends on asset Type: Common Stock â top-level keys: - General: name, exchange, currency, sector, industry, description, etc. - Highlights: marketCap, EBITDA, PE, EPS, dividendYield, etc. - Valuation: trailing/forward PE, PEG, price-to-sales/book, EV ratios - SharesStats: shares outstanding, float, percent insiders/institutions - Technicals: beta, 52wHigh/Low, moving averages, short ratio - SplitsDividends: forward/trailing dividend rate & yield, payout ratio, split history - AnalystRatings: target price, strong buy/buy/hold/sell/strong sell counts - Holders: top institutional & fund holders with shares/weight - InsiderTransactions: array of insider trades (date, name, shares, value) - outstandingShares: quarterly & annual share counts by date - Earnings: History (actual/estimate EPS), Trend, Annual - Financials: Balance_Sheet, Cash_Flow, Income_Statement (quarterly & yearly) ETF â top-level keys: - General, Technicals - ETF_Data: Holdings (top N positions), Sector_Weights, World_Regions, Top_10_Holdings, Asset_Allocation, performance, fees Mutual Fund â top-level keys: - General - MutualFund_Data: fund family, category, NAV, yield, holdings, sector weights Index â General only (pass extra_params={'historical': 1} for components). Examples: "Apple fundamentals" â ticker="AAPL.US" "Tesla earnings and valuation for 2025" â ticker="TSLA.US", sections=["Earnings", "Valuation"], from_date="2025-01-01", to_date="2025-12-31" "Vanguard Total Stock Market ETF info" â ticker="VTI.US", sections=["General", "ETF_Data"] Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
tickerstringrequired- No description.
api_keystring- No description.
api_tokenstring- No description.
extra_paramsstring- No description.
fmtstring- No description.default
json from_datestring- No description.
include_financialsboolean- No description.default
true sectionsstring- No description.
to_datestring- No description.
eodhdmcp_get_historical_commodity_pricesGet historical price data for a commodity series (energy, metals, agriculturals, and commodity indices) sourced from FRED (Federal Reserve Economic Data).Read-onlyGet Historical Commodity Prices
Get historical price data for a commodity series (energy, metals, agriculturals, and commodity indices) sourced from FRED (Federal Reserve Economic Data). Series go back decades for major energy commodities. Costs 5 API calls per request. Use when the user asks for the price history of oil, gas, metals, or agricultural commodities, or a broad commodity index â e.g. WTI/Brent crude, natural gas, gasoline, diesel, copper, aluminum, wheat, corn, sugar, coffee, uranium, coal, or ALL_COMMODITIES.
Inputs
codestringrequired- Commodity code (e.g. 'WTI', 'BRENT', 'URANIUM') or 'ALL_COMMODITIES'. Case-insensitive; normalized to upper case.
api_tokenstring- Per-call token override.
intervalstring- Data frequency â 'daily', 'weekly', 'monthly' (default),
'quarterly', or 'annual'. Daily data is only available for energy commodities.default
monthly
eodhdmcp_get_historical_dividendsGet historical dividend records for a stock, ETF, or fund ticker.Read-onlyGet Historical Dividends
Get historical dividend records for a stock, ETF, or fund ticker. Returns ex-dividend dates, dividend amounts, and for many major tickers also declaration, record, and payment dates. Free access may be limited to roughly 1 year of history, while paid plans can return deeper history. Use when the user asks about dividend history, ex-dividend dates, payout trends, or dividend event details for a specific ticker. For upcoming dividend calendar events across symbols or dates, use get_upcoming_dividends.
Inputs
tickerstringrequired- Symbol in SYMBOL.EXCHANGE format, e.g. 'AAPL.US'.
api_tokenstring- Per-call token override.
end_datestring- 'to' date in YYYY-MM-DD.
fmtstring- 'json' only.default
json start_datestring- 'from' date in YYYY-MM-DD.
eodhdmcp_get_historical_market_capGet historical market capitalization data for a US stock over time.Read-onlyGet Historical Market Cap
Get historical market capitalization data for a US stock over time. Returns weekly market cap data points (from 2020 onward) for NYSE/NASDAQ tickers. Filter by date range. Each request consumes 10 API calls. Use when the user asks about market cap history, company valuation over time, or market cap trends. This is the only tool for historical market cap -- do not confuse with fundamental data or price history. Returns: Array of weekly data points, each with: - date (str): observation date YYYY-MM-DD - value (float): market capitalization in USD Examples: "Apple market cap history in 2025" â ticker="AAPL.US", start_date="2025-01-01", end_date="2025-12-31" "Microsoft market cap last 6 months" â ticker="MSFT.US", start_date="2025-09-06", end_date="2026-03-06" "Google market cap since 2023" â ticker="GOOG.US", start_date="2023-01-01" Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
tickerstringrequired- No description.
api_tokenstring- No description.
end_datestring- No description.
fmtstring- No description.default
json start_datestring- No description.
eodhdmcp_get_historical_splitsGet historical stock split events for a specific ticker.Read-onlyGet Historical Splits
Get historical stock split events for a specific ticker. Returns split dates and split ratios such as 2-for-1, 4-for-1, or reverse split ratios. Use when the user asks about historical splits, reverse splits, or corporate action history for a specific stock. For upcoming split calendar events across symbols or dates, use get_upcoming_splits.
Inputs
tickerstringrequired- Symbol in SYMBOL.EXCHANGE format, e.g. 'AAPL.US'.
api_tokenstring- Per-call token override.
end_datestring- 'to' date in YYYY-MM-DD.
fmtstring- 'json' only.default
json start_datestring- 'from' date in YYYY-MM-DD.
eodhdmcp_get_historical_stock_pricesGet historical daily, weekly, or monthly OHLCV price data for any stock, ETF, index, or crypto.Read-onlyGet Historical Stock Prices
Get historical daily, weekly, or monthly OHLCV price data for any stock, ETF, index, or crypto. Covers open, high, low, close, adjusted close, and volume for a date range. Use for price history, charting, backtesting, and performance analysis. For intraday candles (1min-1h), use get_intraday_historical_data instead. For current/live prices, use get_live_price_data instead.
Inputs
tickerstringrequired- Symbol in SYMBOL.EXCHANGE format, e.g. 'AAPL.US'.
api_tokenstring- Override API token for this call. If not provided, env token is used.
end_datestring- 'to' date in YYYY-MM-DD. If omitted, API returns up to most recent.
filterstring- e.g., 'last_close', 'last_volume' (works with fmt=json; returns a single value).
fmtstring- 'json' or 'csv'. Default 'json'. (API default is csv.)default
json orderstring- 'a' (ascending) or 'd' (descending). Default 'a'.default
a periodstring- 'd' (daily), 'w' (weekly), 'm' (monthly). Default 'd'.default
d start_datestring- 'from' date in YYYY-MM-DD. If omitted, API returns full history (plan limits apply).
eodhdmcp_get_insider_transactionsFetch SEC Form 4 insider trading transactions -- purchases and sales by company officers, directors, and major shareholders.Read-onlyGet Insider Transactions
Fetch SEC Form 4 insider trading transactions -- purchases and sales by company officers, directors, and major shareholders. Returns transaction date, insider name, title, transaction type (P=Purchase, S=Sale), shares, and value. Filter by ticker symbol and/or date range. Each request consumes 10 API calls. Use when the user asks about insider buying/selling activity, executive stock transactions, or Form 4 filings.
Inputs
api_tokenstring- Per-call token; env token used if omitted.
end_datestring- 'to' in YYYY-MM-DD. Defaults to today by API if omitted.
fmtstring- Only 'json' is supported by this tool.default
json limitinteger- Number of entries to return, 1..1000. Default 100.default
100 start_datestring- 'from' in YYYY-MM-DD. Defaults to ~1 year ago by API if omitted.
symbolstring- Filter by ticker (API param 'code'), e.g. 'AAPL' or 'AAPL.US'.
eodhdmcp_get_insider_transactions_form4Get SEC Form 4 insider-trading filings for a US-listed issuer, sourced directly from SEC EDGAR.Read-onlyGet Insider Transactions Form4
Get SEC Form 4 insider-trading filings for a US-listed issuer, sourced directly from SEC EDGAR. This is the richer V2 ("SEC Form 4") endpoint: each filing exposes non-derivative transactions (common stock), derivative transactions (options, RSUs, warrants), and the footnotes referenced from each row, with the full SEC transaction code set and reporting-owner relationship flags. Costs 10 API calls per request. Use when the user asks about insider buying/selling, executive stock transactions, or Form 4 filings for a US company and wants full per-filing detail. For a flat, simpler list across symbols/dates use the legacy get_insider_transactions tool instead.
Inputs
symbolstringrequired- US ticker, e.g. 'AAPL' or 'AAPL.US'. Case-insensitive; the .US suffix is optional. Form 4 is filed by US-listed issuers only â non-US symbols 404.
api_tokenstring- Per-call token override.
limitinteger- Page size, 1..100. Default 20.default
20 offsetinteger- Zero-based pagination offset. Default 0.default
0
eodhdmcp_get_intraday_historical_dataGet historical intraday OHLCV candles at 1-minute, 5-minute, or 1-hour intervals.Read-onlyGet Intraday Historical Data
Get historical intraday OHLCV candles at 1-minute, 5-minute, or 1-hour intervals. Use for intraday price analysis, short-term patterns, and high-resolution charting. Accepts date strings or Unix timestamps for the time range. Max range depends on interval: 1m=120 days, 5m=600 days, 1h=7200 days. For daily/weekly/monthly end-of-day bars, use get_historical_stock_prices instead. For current live price, use get_live_price_data instead.
Inputs
tickerstringrequired- SYMBOL.EXCHANGE_ID, e.g. 'AAPL.US'.
api_tokenstring- Per-call token override; env token used if omitted.
fmtstring- 'json' or 'csv'. Default 'json'.default
json from_timestampstring- Start as Unix seconds OR a date string (auto-detected). Examples: 1704067200, '2024-01-01', '01-01-24', '01/01/2024', '2024-01-01T15:30:00Z', 'Jan 1, 2024'.
intervalstring- One of {'1m','5m','1h'}. Default '5m'.default
5m split_dtstring- If True, adds 'split-dt=1' to split date/time fields.default
false to_timestampstring- End as Unix seconds OR a date string (auto-detected).
eodhdmcp_get_live_price_dataGet the current (delayed ~15-20 min) price snapshot for one or more tickers.Read-onlyGet Live Price Data
Get the current (delayed ~15-20 min) price snapshot for one or more tickers. Returns last trade price, change, change percent, volume, high, low, open, previous close, and timestamp. Supports stocks, ETFs, indices, forex, and crypto. Batch up to 20 symbols in one call. For US stocks with bid/ask, 52w range, and market cap, use get_us_live_extended_quotes instead. For historical daily/weekly/monthly OHLCV, use get_historical_stock_prices instead.
Inputs
tickerstringrequired- Primary symbol in SYMBOL.EXCHANGE format (e.g., 'AAPL.US'). Required and placed in the path, per API spec.
additional_symbolsstring- Extra symbols for 's=' query param, comma-separated by the tool (e.g., ['VTI', 'EUR.FOREX']). Docs recommend <= 15â20 total.
api_tokenstring- Per-call token override. If omitted, env token is used.
fmtstring- 'json' or 'csv'. Defaults to 'json' for easier client handling.default
json
eodhdmcp_get_macro_indicatorFetch macroeconomic indicators for a country over time.Read-onlyGet Macro Indicator
Fetch macroeconomic indicators for a country over time. Use when the user asks about country-level economic data: GDP, inflation, CPI, unemployment, population, trade balance, debt-to-GDP, life expectancy, and 30+ other World Bank-style indicators. Returns a historical time series for one indicator in one country. Country is specified by ISO-3 alpha code (e.g., USA, DEU, FRA). Defaults to GDP if no indicator specified. This is for country-level macro data only. For company fundamentals, use get_fundamentals_data (single ticker) or get_bulk_fundamentals (entire exchange).
Inputs
countrystringrequired- Alpha-3 ISO country code (e.g., 'USA', 'FRA', 'DEU').
api_tokenstring- Per-call token override.
fmtstring- 'json' or 'csv'. Default 'json'.default
json indicatorstring- One of documented indicators. Defaults to 'gdp_current_usd'.
eodhdmcp_get_mp_investverte_esg_list_companies[InvestVerte] List all companies available in the ESG dataset.Read-onlyGet Mp Investverte Esg List Companies
[InvestVerte] List all companies available in the ESG dataset. Returns an array of symbol/name pairs for every company with ESG coverage. Use as a reference lookup before calling get_mp_investverte_esg_view_company for detailed ESG scores. Consumes 10 API calls per request. For country or sector reference lists, use get_mp_investverte_esg_list_countries or list_sectors. Returns: A JSON-formatted string containing an array of objects: [ {"symbol": "000001.SZ", "name": "Ping An Bank Co., Ltd."}, {"symbol": "000002.SZ", "name": "China Vanke Co., Ltd."}, ... ] Notes: - This endpoint lists all companies covered by the Investverte ESG dataset. - Rate limits (Marketplace product): * 100,000 API calls per 24 hours * 1,000 API requests per minute * 1 API request = 10 API calls Examples: "List all ESG companies" â (no params needed) "Which companies have ESG data?" â (no params needed)
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_get_mp_investverte_esg_list_countries[InvestVerte] List all countries available in the ESG dataset.Read-onlyGet Mp Investverte Esg List Countries
[InvestVerte] List all countries available in the ESG dataset. Returns an array of country_code/country_descr pairs for every country with ESG coverage. Use as a reference lookup before calling get_mp_investverte_esg_view_country for detailed ESG scores. Consumes 10 API calls per request. For company or sector reference lists, use get_mp_investverte_esg_list_companies or list_sectors. Returns: A JSON-formatted string containing an array of objects: [ {"country_code": "AD", "country_descr": "Andorra"}, {"country_code": "AE", "country_descr": "United Arab Emirates"}, ... ] Notes: - This endpoint lists all countries covered by the Investverte ESG dataset. - Rate limits (Marketplace product): * 100,000 API calls per 24 hours * 1,000 API requests per minute * 1 API request = 10 API calls Examples: "List all ESG countries" â (no params needed) "Which countries have ESG ratings?" â (no params needed)
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_get_mp_investverte_esg_list_sectors[InvestVerte] List all sectors available in the ESG dataset.Read-onlyGet Mp Investverte Esg List Sectors
[InvestVerte] List all sectors available in the ESG dataset. Returns an array of sector names with ESG coverage (e.g., "Airlines", "Aerospace & Defense"). Use as a reference lookup before calling get_mp_investverte_esg_view_sector for detailed ESG data. Consumes 10 API calls per request. For company or country reference lists, use get_mp_investverte_esg_list_companies or list_countries. Returns: A JSON-formatted string containing an array of objects: [ {"sector": "Aerospace & Defense"}, {"sector": "Airlines"}, ... ] Notes: - This endpoint lists all sectors covered by the Investverte ESG dataset. - Rate limits (Marketplace product): * 100,000 API calls per 24 hours * 1,000 API requests per minute * 1 API request = 10 API calls Examples: "List all ESG sectors" â (no params needed) "What sectors have ESG coverage?" â (no params needed)
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_get_mp_investverte_esg_view_company[InvestVerte] Get detailed ESG scores (E, S, G, and composite) for a specific company by symbol.Read-onlyGet Mp Investverte Esg View Company
[InvestVerte] Get detailed ESG scores (E, S, G, and composite) for a specific company by symbol. Returns Environmental, Social, Governance, and combined ESG scores broken down by year and frequency (FY, Q1-Q4). Optionally filter by year and frequency. Consumes 10 API calls per request. Use get_mp_investverte_esg_list_companies first to discover available symbols. For country-level ESG, use get_mp_investverte_esg_view_country. For sector-level ESG, use get_mp_investverte_esg_view_sector. Returns: A JSON-formatted string with an array of objects, e.g.: [ { "e": 58.97, "s": 68.66, "g": 65.21, "esg": 64.09, "year": 2021, "frequency": "FY" }, ... ] Notes: - Year and frequency are optional; when omitted, all available years/frequencies for the symbol are returned. - Rate limits (Marketplace product): * 100,000 API calls per 24 hours * 1,000 API requests per minute * 1 API request = 10 API calls Examples: - /api/mp/investverte/esg/AAPL?year=2021&frequency=FY - /api/mp/investverte/esg/000039.SZ
Inputs
symbolstringrequired- No description.
api_tokenstring- No description.
fmtstring- No description.default
json frequencystring- No description.
yearstring- No description.
eodhdmcp_get_mp_investverte_esg_view_country[InvestVerte] Get detailed ESG ratings for a specific country by country code.Read-onlyGet Mp Investverte Esg View Country
[InvestVerte] Get detailed ESG ratings for a specific country by country code. Returns mean and median ESG scores broken down by year and frequency (FY, Q1-Q4). Optionally filter by year and frequency. Consumes 10 API calls per request. Use get_mp_investverte_esg_list_countries first to discover available country codes. For company-level ESG, use get_mp_investverte_esg_view_company. For sector-level ESG, use get_mp_investverte_esg_view_sector. Returns: A JSON-formatted string with an array of objects, e.g.: [ { "symbol": "US", "name": "United States of America", "mean": 63.2928294103373, "median": 63.32, "year": 2021, "frequency": "FY" }, ... ] Notes: - Year and frequency are optional; when omitted, all available years/frequencies for the country are returned. - Rate limits (Marketplace product): * 100,000 API calls per 24 hours * 1,000 API requests per minute * 1 API request = 10 API calls Examples: - /api/mp/investverte/country/US?year=2021&frequency=FY - /api/mp/investverte/country/US
Inputs
symbolstringrequired- No description.
api_tokenstring- No description.
fmtstring- No description.default
json frequencystring- No description.
yearstring- No description.
eodhdmcp_get_mp_investverte_esg_view_sector[InvestVerte] Get detailed ESG time-series data for a specific sector by name.Read-onlyGet Mp Investverte Esg View Sector
[InvestVerte] Get detailed ESG time-series data for a specific sector by name. Returns ESG values mapped by industry/sub-sector across all available year-frequency combinations (e.g., "2015-FY", "2021-Q3"). Consumes 10 API calls per request. Use get_mp_investverte_esg_list_sectors first to discover available sector names. For company-level ESG, use get_mp_investverte_esg_view_company. For country-level ESG, use get_mp_investverte_esg_view_country. Returns: A JSON-formatted string with a sector ESG object: { "find": true, "industry": { "Airlines": [<ESG values per year>], "Transportation": [<ESG values per year>] }, "years": ["2015-FY", "2015-Q1", ...] } Fields: - find (bool): whether the sector was found - industry (object): map of industry/sector names to arrays of ESG values aligned with the "years" axis - years (array of str): time axis labels in "YYYY-frequency" format Notes: - The 'industry' section contains sector/industry names mapped to ESG values over the 'years' axis. - Rate limits (Marketplace product): * 100,000 API calls per 24 hours * 1,000 API requests per minute * 1 API request = 10 API calls Examples: "Airlines sector ESG data" â symbol="Airlines" "Aerospace & Defense ESG ratings" â symbol="Aerospace & Defense"
Inputs
symbolstringrequired- No description.
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_get_mp_praams_bank_balance_sheet_by_isin[PRAAMS] Retrieve bank-specific balance sheet time series by ISIN code.Read-onlyGet Mp Praams Bank Balance Sheet By Isin
[PRAAMS] Retrieve bank-specific balance sheet time series by ISIN code. Returns annual and quarterly data: loans, cash, deposits, securities REPO, investment portfolio, debt, total assets/equity, interest-earning assets, and interest-bearing liabilities. Tailored for banking sector analysis. Consumes 10 API calls per request. For lookup by ticker, use get_mp_praams_bank_balance_sheet_by_ticker. For bank income statement data, use get_mp_praams_bank_income_statement_by_isin. Returns: JSON object with Praams envelope: - success (bool): whether the request succeeded - items (array): time-series of balance sheet entries, each containing: - period (str): reporting period (e.g. "2023-Q4", "2023-FY") - loansGross (float|null): gross loans - loansProvisions (float|null): loan loss provisions - loansNet (float|null): net loans - cashEquivalents (float|null): cash & equivalents - depositsWithBanks (float|null): deposits with other banks - securitiesRepoAssets (float|null): securities REPO assets - securitiesRepoLiabilities (float|null): securities REPO liabilities - investmentPortfolio (float|null): investment portfolio - totalAssets (float|null): total assets - totalEquity (float|null): total equity - shortTermDebt (float|null): short-term debt - longTermDebt (float|null): long-term debt - interestEarningAssets (float|null): interest-earning assets - interestBearingLiabilities (float|null): interest-bearing liabilities - Additional bank-specific balance sheet line items - message (str): status message - errors (array): list of error messages, empty on success Limits (Marketplace rules): - 1 request = 10 API calls - 100k calls / 24h, 1k requests / minute - Output is JSON only
Inputs
isinstringrequired- No description.
api_tokenstring- No description.
eodhdmcp_get_mp_praams_bank_balance_sheet_by_ticker[PRAAMS] Retrieve bank-specific balance sheet time series by ticker symbol.Read-onlyGet Mp Praams Bank Balance Sheet By Ticker
[PRAAMS] Retrieve bank-specific balance sheet time series by ticker symbol. Returns annual and quarterly data: loans, cash, deposits, securities REPO, investment portfolio, debt, total assets/equity, interest-earning assets, and interest-bearing liabilities. Tailored for banking sector analysis. Consumes 10 API calls per request. For lookup by ISIN, use get_mp_praams_bank_balance_sheet_by_isin. For bank income statement data, use get_mp_praams_bank_income_statement_by_ticker. Returns: JSON object with Praams envelope: - success (bool): whether the request succeeded - items (array): time-series of balance sheet entries, each containing: - period (str): reporting period (e.g. "2023-Q4", "2023-FY") - loansGross (float|null): gross loans - loansProvisions (float|null): loan loss provisions - loansNet (float|null): net loans - cashEquivalents (float|null): cash & equivalents - depositsWithBanks (float|null): deposits with other banks - securitiesRepoAssets (float|null): securities REPO assets - securitiesRepoLiabilities (float|null): securities REPO liabilities - investmentPortfolio (float|null): investment portfolio - totalAssets (float|null): total assets - totalEquity (float|null): total equity - shortTermDebt (float|null): short-term debt - longTermDebt (float|null): long-term debt - interestEarningAssets (float|null): interest-earning assets - interestBearingLiabilities (float|null): interest-bearing liabilities - Additional bank-specific balance sheet line items - message (str): status message - errors (array): list of error messages, empty on success Limits (Marketplace rules): - 1 request = 10 API calls - 100k calls / 24h, 1k requests / minute - Output is JSON only
Inputs
tickerstringrequired- No description.
api_tokenstring- No description.
eodhdmcp_get_mp_praams_bank_income_statement_by_isin[PRAAMS] Retrieve bank-specific income statement time series by ISIN code.Read-onlyGet Mp Praams Bank Income Statement By Isin
[PRAAMS] Retrieve bank-specific income statement time series by ISIN code. Returns annual and quarterly data: core revenue, net interest income, fee & commission income, RIBPT, non-recurring income, IBPT, and provisioning. Tailored for banking sector analysis. Consumes 10 API calls per request. For lookup by ticker, use get_mp_praams_bank_income_statement_by_ticker. For bank balance sheet data, use get_mp_praams_bank_balance_sheet_by_isin. Returns: JSON object with Praams envelope: - success (bool): whether the request succeeded - items (array): time-series of income statement entries, each containing: - period (str): reporting period (e.g. "2023-Q4", "2023-FY") - coreRevenue (float|null): total core revenue - netInterestIncome (float|null): net interest income - netFeeCommissionIncome (float|null): net fee & commission income - ribpt (float|null): recurring income before provisioning and taxes - nonRecurringIncome (float|null): non-recurring income items - ibpt (float|null): income before provisioning and taxes - provisioning (float|null): loan loss provisions - Additional bank-specific income line items - message (str): status message - errors (array): list of error messages, empty on success Limits (Marketplace rules): - 1 request = 10 API calls - 100k calls / 24h, 1k requests / minute - Output is JSON only
Inputs
isinstringrequired- No description.
api_tokenstring- No description.
eodhdmcp_get_mp_praams_bank_income_statement_by_ticker[PRAAMS] Retrieve bank-specific income statement time series by ticker symbol.Read-onlyGet Mp Praams Bank Income Statement By Ticker
[PRAAMS] Retrieve bank-specific income statement time series by ticker symbol. Returns annual and quarterly data: core revenue, net interest income, fee & commission income, RIBPT, non-recurring income, IBPT, and provisioning. Tailored for banking sector analysis. Consumes 10 API calls per request. For lookup by ISIN, use get_mp_praams_bank_income_statement_by_isin. For bank balance sheet data, use get_mp_praams_bank_balance_sheet_by_ticker. Returns: JSON object with Praams envelope: - success (bool): whether the request succeeded - items (array): time-series of income statement entries, each containing: - period (str): reporting period (e.g. "2023-Q4", "2023-FY") - coreRevenue (float|null): total core revenue - netInterestIncome (float|null): net interest income - netFeeCommissionIncome (float|null): net fee & commission income - ribpt (float|null): recurring income before provisioning and taxes - nonRecurringIncome (float|null): non-recurring income items - ibpt (float|null): income before provisioning and taxes - provisioning (float|null): loan loss provisions - Additional bank-specific income line items - message (str): status message - errors (array): list of error messages, empty on success Limits (Marketplace rules): - 1 request = 10 API calls - 100k calls / 24h, 1k requests / minute - Output is JSON only
Inputs
tickerstringrequired- No description.
api_tokenstring- No description.
eodhdmcp_get_mp_praams_bond_analyze_by_isin[PRAAMS] Get deep risk-return analysis for a bond identified by ISIN code.Read-onlyGet Mp Praams Bond Analyze By Isin
[PRAAMS] Get deep risk-return analysis for a bond identified by ISIN code. Returns PRAAMS ratio, coupon profile, credit/solvency assessment, stress-manual results, volatility, liquidity, country risk narratives, and issuer-level fundamentals. Use for detailed bond-specific due diligence. Consumes 10 API calls per request. For bond screening across multiple instruments, use get_mp_praams_smart_screener_bond. For a full PDF bond report, use get_mp_praams_report_bond_by_isin. Returns: JSON object with Praams envelope: - success (bool): whether the request succeeded - item (object): bond analysis payload containing: - praamsRatio (float): overall PRAAMS score - totalReturnScore (int): aggregate return score (1-7 scale) - totalRiskScore (int): aggregate risk score (1-7 scale) - coupon (object): coupon profile (type, rate, frequency, structure notes) - valuation (object): yield-to-maturity, spread, price metrics - performance (object): price and total return performance - profitability (object): issuer-level profitability metrics - growthMomentum (object): issuer growth & momentum - marketView (object): spread history, yield curve positioning - volatility (object): price volatility, duration-adjusted risk - stressTest (object): stress-manual scenarios and score - liquidity (object): trading volume, bid-ask spread, score - countryRisk (object): country-level risk assessment and score - solvency (object): issuer creditworthiness, leverage, coverage ratios - descriptions (object|null): narrative risk/return explanations - errors (array): list of error messages, empty on success - message (str): status message Limits (Marketplace rules): - 1 request = 10 API calls - 100k calls / 24h, 1k requests / minute - Output is JSON only
Inputs
isinstringrequired- No description.
api_tokenstring- No description.
eodhdmcp_get_mp_praams_report_bond_by_isin[PRAAMS] Generate a comprehensive multi-factor PDF report for a bond by ISIN code.Read-onlyGet Mp Praams Report Bond By Isin
[PRAAMS] Generate a comprehensive multi-factor PDF report for a bond by ISIN code. Covers 120,000+ global bonds (corporate and sovereign). Report includes valuation, performance, coupon analysis, profitability, growth, plus risk factors (volatility, stress-manual, liquidity, country, solvency). Requires an email for delivery notification. Consumes 10 API calls per request. For JSON bond analysis without PDF, use get_mp_praams_bond_analyze_by_isin. For equity PDF reports, use get_mp_praams_report_equity_by_ticker or by_isin.
Inputs
emailstringrequired- Email address for report notifications.
isinstringrequired- ISIN code of the bond (e.g. 'US7593518852', 'US91282CJN20').
api_tokenstring- Per-call token override; env token used otherwise.
is_fullstring- True for full report, False for partial.
eodhdmcp_get_mp_praams_report_equity_by_isin[PRAAMS] Generate a comprehensive multi-factor PDF report for an equity by ISIN code.Read-onlyGet Mp Praams Report Equity By Isin
[PRAAMS] Generate a comprehensive multi-factor PDF report for an equity by ISIN code. Covers 120,000+ global equities. Report includes valuation, performance, profitability, growth, dividends, analyst view, plus risk factors (volatility, stress-manual, liquidity, country, solvency). Requires an email for delivery notification. Consumes 10 API calls per request. For report by ticker, use get_mp_praams_report_equity_by_ticker. For JSON risk scoring without PDF, use get_mp_praams_risk_scoring_by_isin.
Inputs
emailstringrequired- Email address for report notifications.
isinstringrequired- ISIN code (e.g. 'US0378331005' for Apple, 'US88160R1014' for Tesla).
api_tokenstring- Per-call token override; env token used otherwise.
is_fullstring- True for full report, False for partial.
eodhdmcp_get_mp_praams_report_equity_by_ticker[PRAAMS] Generate a comprehensive multi-factor PDF report for an equity by ticker symbol.Read-onlyGet Mp Praams Report Equity By Ticker
[PRAAMS] Generate a comprehensive multi-factor PDF report for an equity by ticker symbol. Covers 120,000+ global equities. Report includes valuation, performance, profitability, growth, dividends, analyst view, plus risk factors (volatility, stress-manual, liquidity, country, solvency). Requires an email for delivery notification. Consumes 10 API calls per request. For report by ISIN, use get_mp_praams_report_equity_by_isin. For JSON risk scoring without PDF, use get_mp_praams_risk_scoring_by_ticker.
Inputs
emailstringrequired- Email address for report notifications.
tickerstringrequired- Ticker symbol (e.g. 'AAPL', 'TSLA', 'AMZN').
api_tokenstring- Per-call token override; env token used otherwise.
is_fullstring- True for full report, False for partial.
eodhdmcp_get_mp_praams_risk_scoring_by_isin[PRAAMS] Get risk scores and risk-return decomposition for an equity identified by ISIN code.Read-onlyGet Mp Praams Risk Scoring By Isin
[PRAAMS] Get risk scores and risk-return decomposition for an equity identified by ISIN code. Returns overall PRAAMS ratio (1-7), sub-scores for valuation, performance, profitability, growth, dividends, volatility, liquidity, stress-manual, country risk, and solvency. Use when assessing investment risk and you have the ISIN. Consumes 10 API calls per request. For lookup by ticker instead of ISIN, use get_mp_praams_risk_scoring_by_ticker. For a full PDF report, use get_mp_praams_report_equity_by_isin. Returns: JSON object with Praams envelope: - success (bool): whether the request succeeded - item (object): equity analysis payload containing: - praamsRatio (float): overall PRAAMS score - totalReturnScore (int): aggregate return score (1-7 scale) - totalRiskScore (int): aggregate risk score (1-7 scale) - valuation (object): valuation metrics and score - performance (object): performance metrics and score - profitability (object): profitability metrics and score - growthMomentum (object): growth & momentum metrics and score - dividends (object): dividend yield, payout ratio, score - analystView (object): consensus target price, recommendations, score - volatility (object): historical volatility, VaR, score - stressTest (object): stress-manual scenarios and score - liquidity (object): trading volume, bid-ask spread, score - countryRisk (object): country-level risk assessment and score - solvency (object): debt ratios, interest coverage, score - descriptions (object|null): narrative risk/return explanations - errors (array): list of error messages, empty on success - message (str): status message Limits (Marketplace rules): - 1 request = 10 API calls - 100k calls / 24h, 1k requests / minute - Output is JSON only
Inputs
isinstringrequired- No description.
api_tokenstring- No description.
eodhdmcp_get_mp_praams_risk_scoring_by_ticker[PRAAMS] Get risk scores and risk-return decomposition for an equity identified by ticker symbol.Read-onlyGet Mp Praams Risk Scoring By Ticker
[PRAAMS] Get risk scores and risk-return decomposition for an equity identified by ticker symbol. Returns overall PRAAMS ratio (1-7), sub-scores for valuation, performance, profitability, growth, dividends, volatility, liquidity, stress-manual, country risk, and solvency. Use when assessing investment risk for a specific stock or ETF. Consumes 10 API calls per request. For lookup by ISIN instead of ticker, use get_mp_praams_risk_scoring_by_isin. For a full PDF report, use get_mp_praams_report_equity_by_ticker. Returns: JSON object with Praams envelope: - success (bool): whether the request succeeded - item (object): equity analysis payload containing: - praamsRatio (float): overall PRAAMS score - totalReturnScore (int): aggregate return score (1-7 scale) - totalRiskScore (int): aggregate risk score (1-7 scale) - valuation (object): valuation metrics and score - performance (object): performance metrics and score - profitability (object): profitability metrics and score - growthMomentum (object): growth & momentum metrics and score - dividends (object): dividend yield, payout ratio, score - analystView (object): consensus target price, recommendations, score - volatility (object): historical volatility, VaR, score - stressTest (object): stress-manual scenarios and score - liquidity (object): trading volume, bid-ask spread, score - countryRisk (object): country-level risk assessment and score - solvency (object): debt ratios, interest coverage, score - descriptions (object|null): narrative risk/return explanations - errors (array): list of error messages, empty on success - message (str): status message Limits (Marketplace rules): - 1 request = 10 API calls - 100k calls / 24h, 1k requests / minute - Output is JSON only
Inputs
tickerstringrequired- No description.
api_tokenstring- No description.
eodhdmcp_get_mp_praams_smart_screener_bond[PRAAMS] Screen and filter bonds using multi-factor risk-return criteria.Read-onlyGet Mp Praams Smart Screener Bond
[PRAAMS] Screen and filter bonds using multi-factor risk-return criteria. Filter by region, country, sector, currency, yield range, duration range, PRAAMS score ranges (1-7), and exclude subordinated or perpetual bonds. Returns paginated matching bonds with scores. Consumes 10 API calls per request. For equity screening, use get_mp_praams_smart_screener_equity. For deep analysis of a single bond, use get_mp_praams_bond_analyze_by_isin. Returns: JSON object with Praams envelope: - item (object): - peers (array): matching bond instruments, each containing: - isin (str): bond ISIN - name (str): bond/issuer name - praamsRatio (float): overall PRAAMS score - totalReturnScore (int): return score (1-7) - totalRiskScore (int): risk score (1-7) - yield (float|null): current yield - duration (float|null): effective duration - couponRate (float|null): coupon rate - maturityDate (str|null): maturity date - currency (str): bond currency - country (str): issuer country - sector (str): issuer sector - totalCount (int): total matching instruments (for pagination) - success (bool): whether the request succeeded - message (str): status message - errors (array): list of error messages, empty on success Notes: - All *Min/*Max fields are 1..7 scale integers (nullable). - Bond-specific: yieldMin/Max, durationMin/Max, excludeSubordinated, excludePerpetuals. - Provide at least one filter value in the JSON body. Examples: "High-yield EUR bonds low risk" â currency=["EUR"], yieldMin=5, countryRiskMax=3 "US investment-grade bonds short duration" â regions=[1], durationMax=3, solvencyMin=5
Inputs
analystViewMaxstring- No description.
analystViewMinstring- No description.
api_tokenstring- No description.
capitalisationstring- No description.
countriesstring- No description.
countryRiskMaxstring- No description.
countryRiskMinstring- No description.
couponsMaxstring- No description.
couponsMinstring- No description.
currencystring- No description.
dividendsMaxstring- No description.
dividendsMinstring- No description.
durationMaxstring- No description.
durationMinstring- No description.
excludePerpetualsstring- No description.
excludeSubordinatedstring- No description.
growthMomMaxstring- No description.
growthMomMinstring- No description.
industriesstring- No description.
liquidityMaxstring- No description.
liquidityMinstring- No description.
mainRatioMaxstring- No description.
mainRatioMinstring- No description.
marketViewMaxstring- No description.
marketViewMinstring- No description.
orderBystring- No description.
otherMaxstring- No description.
otherMinstring- No description.
performanceMaxstring- No description.
performanceMinstring- No description.
profitabilityMaxstring- No description.
profitabilityMinstring- No description.
regionsstring- No description.
sectorsstring- No description.
skipstring- No description.default
0 solvencyMaxstring- No description.
solvencyMinstring- No description.
stressTestMaxstring- No description.
stressTestMinstring- No description.
takestring- No description.default
50 valuationMaxstring- No description.
valuationMinstring- No description.
volatilityMaxstring- No description.
volatilityMinstring- No description.
yieldMaxstring- No description.
yieldMinstring- No description.
eodhdmcp_get_mp_praams_smart_screener_equity[PRAAMS] Screen and filter equities using multi-factor risk-return criteria.Read-onlyGet Mp Praams Smart Screener Equity
[PRAAMS] Screen and filter equities using multi-factor risk-return criteria. Filter by region, country, sector, industry, market cap, currency, and PRAAMS score ranges (1-7) for valuation, performance, profitability, growth, dividends, analyst view, and risk factors. Returns paginated matching equities with scores. Consumes 10 API calls per request. For bond screening, use get_mp_praams_smart_screener_bond. For deep analysis of a single equity, use get_mp_praams_risk_scoring_by_ticker. Returns: JSON object with Praams envelope: - item (object): - peers (array): matching equity instruments, each containing: - ticker (str): equity ticker symbol - isin (str): ISIN code - name (str): company name - praamsRatio (float): overall PRAAMS score - totalReturnScore (int): return score (1-7) - totalRiskScore (int): risk score (1-7) - valuation (int): valuation score (1-7) - performance (int): performance score (1-7) - profitability (int): profitability score (1-7) - dividends (int): dividends score (1-7) - country (str): company country - sector (str): company sector - capitalisation (int): market cap category (1=small, 2=mid, 3=large) - currency (str): trading currency - totalCount (int): total matching instruments (for pagination) - success (bool): whether the request succeeded - message (str): status message - errors (array): list of error messages, empty on success Notes: - All *Min/*Max fields are 1..7 scale integers (nullable). - Provide at least one filter value in the JSON body. Examples: "Large-cap US tech stocks with high dividends" â capitalisation=[3], regions=[1], dividendsMin=5 "European equities low volatility risk" â regions=[2], currency=["EUR"], volatilityMax=2
Inputs
analystViewMaxstring- No description.
analystViewMinstring- No description.
api_tokenstring- No description.
capitalisationstring- No description.
countriesstring- No description.
countryRiskMaxstring- No description.
countryRiskMinstring- No description.
currencystring- No description.
dividendsMaxstring- No description.
dividendsMinstring- No description.
growthMomMaxstring- No description.
growthMomMinstring- No description.
industriesstring- No description.
liquidityMaxstring- No description.
liquidityMinstring- No description.
mainRatioMaxstring- No description.
mainRatioMinstring- No description.
orderBystring- No description.
otherMaxstring- No description.
otherMinstring- No description.
performanceMaxstring- No description.
performanceMinstring- No description.
profitabilityMaxstring- No description.
profitabilityMinstring- No description.
regionsstring- No description.
sectorsstring- No description.
skipstring- No description.default
0 solvencyMaxstring- No description.
solvencyMinstring- No description.
stressTestMaxstring- No description.
stressTestMinstring- No description.
takestring- No description.default
50 valuationMaxstring- No description.
valuationMinstring- No description.
volatilityMaxstring- No description.
volatilityMinstring- No description.
eodhdmcp_get_mp_tick_data[Marketplace] Fetch individual trade ticks (tick-by-tick data) for US stocks.Read-onlyGet Mp Tick Data
[Marketplace] Fetch individual trade ticks (tick-by-tick data) for US stocks. Use when asked about granular trade-level data, tick history, or microstructure analysis. Returns timestamp (ms), price, shares, market center, and sequence for each trade. Covers US equities only. Time range defaults to yesterday if not specified. This is the paid Marketplace tick data provider. For free-tier tick data, use get_us_tick_data. Consumes 10 API calls per request.
Inputs
tickerstringrequired- Ticker symbol, max 30 chars (e.g. 'AAPL', 'MSFT').
api_tokenstring- Per-call token override; env token used otherwise.
from_timestampstring- Start UNIX time in seconds. Default: yesterday start.
limitstring- Max ticks to return (1-10000). Default: all in range.
to_timestampstring- End UNIX time in seconds. Default: yesterday end.
eodhdmcp_get_mp_tradinghours_list_markets[TradingHours] List all tracked global markets and exchanges.Read-onlyGet Mp Tradinghours List Markets
[TradingHours] List all tracked global markets and exchanges. Use as the starting point to browse available markets before looking up details or checking status. Returns FinID, exchange name, MIC code, asset type, and group for each market. Filter by group: 'core' (24 G20+ markets), 'extended', 'all', or 'allowed' (your tier). To search markets by name/country, use get_mp_tradinghours_lookup_markets. For detailed info on one market, use get_mp_tradinghours_market_details. Consumes 10 API calls per request.
Inputs
api_tokenstring- Per-call token override; env token used otherwise.
groupstring- Filter markets â 'core' (G20+), 'extended' (global equities), 'all' (equities + derivatives), 'allowed' (your tier). Default: 'all'.
eodhdmcp_get_mp_tradinghours_lookup_markets[TradingHours] Search for markets by name, MIC code, country, or free-form query.Read-onlyGet Mp Tradinghours Lookup Markets
[TradingHours] Search for markets by name, MIC code, country, or free-form query. Use when the user asks to find a specific exchange or market by keyword (e.g. "Tokyo", "XNYS", "Germany"). Covers 900+ global trading schedules. To list all markets without searching, use get_mp_tradinghours_list_markets. For full details on a found market, pass its fin_id to get_mp_tradinghours_market_details. Consumes 10 API calls per request.
Inputs
api_tokenstring- Per-call token override; env token used otherwise.
groupstring- Filter results â 'core', 'extended', 'all', 'allowed'. Default: 'all'.
qstring- Free-form search query (exchange name, market name, MIC, country). Omit to return all markets.
eodhdmcp_get_mp_tradinghours_market_details[TradingHours] Get detailed metadata for a specific market by its FinID.Read-onlyGet Mp Tradinghours Market Details
[TradingHours] Get detailed metadata for a specific market by its FinID. Use when asked about an exchange's timezone, MIC codes, asset types, weekend schedule, or holiday date range. Returns country, timezone (IANA), products traded, MIC/MIC extended, acronym, and more. Find the FinID first via get_mp_tradinghours_list_markets or get_mp_tradinghours_lookup_markets. For real-time open/closed status, use get_mp_tradinghours_market_status instead. Consumes 10 API calls per request.
Inputs
fin_idstringrequired- Market FinID, case-insensitive (e.g. 'us.nyse', 'gb.lse').
api_tokenstring- Per-call token override; env token used otherwise.
eodhdmcp_get_mp_tradinghours_market_status[TradingHours] Check whether a market is currently open or closed.Read-onlyGet Mp Tradinghours Market Status
[TradingHours] Check whether a market is currently open or closed. Use when asked "is the NYSE open?", "when does Tokyo close?", or any real-time market status question. Returns status (Open/Closed), reason, time until next status change, and next bell time. Does not cover circuit breakers or individual stock trading halts. Find the FinID first via get_mp_tradinghours_list_markets or get_mp_tradinghours_lookup_markets. For static market metadata (timezone, MIC, holidays), use get_mp_tradinghours_market_details. Consumes 10 API calls per request.
Inputs
fin_idstringrequired- Market FinID, case-insensitive (e.g. 'us.nyse').
api_tokenstring- Per-call token override; env token used otherwise.
eodhdmcp_get_news_word_weightsGet top weighted keywords from news articles for a given stock ticker over a date range.Read-onlyGet News Word Weights
Get top weighted keywords from news articles for a given stock ticker over a date range. Returns word frequency and importance scores, useful for identifying dominant themes and narratives in coverage. Use when analyzing what topics or terms dominate news about a company. For raw news articles, use get_company_news instead. For aggregated sentiment scores, use get_sentiment_data instead.
Inputs
tickerstringrequired- Symbol to analyze (e.g., 'AAPL.US'); mapped to 's'.
api_tokenstring- Per-call token override.
end_datestring- YYYY-MM-DD; mapped to filter[date_to].
fmtstring- 'json' (default). (CSV/XML not documented for this endpoint.)default
json limitstring- Number of top words; mapped to page[limit].
start_datestring- YYYY-MM-DD; mapped to filter[date_from].
eodhdmcp_get_rates_funding_stressFetch funding-stress spreads.Read-onlyGet Rates Funding Stress
Fetch funding-stress spreads. Use when the user asks about money-market funding stress, rate spreads between two legs (e.g. SOFR minus EFFR), or funding-stress indicators in basis points. Returns funding-stress spread time series, including the two component legs and their rates. Filterable by code and date range. This endpoint is NOT paginated.
Inputs
api_tokenstring- Per-call token override.
codestring- Spread code.
date_fromstring- Start date filter (YYYY-MM-DD).
date_tostring- End date filter (YYYY-MM-DD).
fmtstring- 'json' or 'csv'. Default 'json'.default
json
eodhdmcp_get_rates_policy_ratesFetch central bank policy rates.Read-onlyGet Rates Policy Rates
Fetch central bank policy rates. Use when the user asks about policy interest rates set by central banks (e.g. Fed funds rate, ECB, Bank of England), or policy rate history by country or central bank. Returns central bank policy rate time series. Filterable by code, country, central bank, and date range. Paginated.
Inputs
api_tokenstring- Per-call token override.
central_bankstring- Central bank.
codestring- Rate code.
countrystring- Country or policy jurisdiction name/code.
date_fromstring- Start date filter (YYYY-MM-DD).
date_tostring- End date filter (YYYY-MM-DD).
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
eodhdmcp_get_rates_reference_ratesFetch benchmark reference interest rates.Read-onlyGet Rates Reference Rates
Fetch benchmark reference interest rates. Use when the user asks about reference rates such as SOFR, SONIA, ESTR, or other USD/GBP/EUR overnight and benchmark rates over time. Returns reference rate time series by code and currency. Filterable by code, currency, and date range. Paginated.
Inputs
api_tokenstring- Per-call token override.
codestring- Rate code (e.g. 'SOFR', 'SONIA', 'ESTR').
currencystring- Currency: 'USD', 'GBP', or 'EUR'.
date_fromstring- Start date filter (YYYY-MM-DD).
date_tostring- End date filter (YYYY-MM-DD).
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
eodhdmcp_get_real_estate_countriesList countries and BIS aggregates covered by the Real Estate Data API.Read-onlyGet Real Estate Countries
List countries and BIS aggregates covered by the Real Estate Data API. Each record contains ``code``, ``name``, ``has_spp``, and ``has_dpp``. JSON returns the upstream ``data``/``meta``/``links`` envelope unchanged; CSV returns plain text. Costs 5 API calls.
Inputs
api_tokenstring- Per-call token override. If omitted, env token is used.
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page.
offsetstring- Pagination offset.
sortstring- Sort order for returned records.
eodhdmcp_get_real_estate_detailed_pricesFetch granular BIS Detailed Property Price observations.Read-onlyGet Real Estate Detailed Prices
Fetch granular BIS Detailed Property Price observations. Filters cover area, property type, vintage, frequency, and period. JSON returns the upstream envelope unchanged and is capped at 250 rows to keep MCP responses manageable; CSV preserves the upstream 500-row maximum. Costs 5 API calls.
Inputs
codestringrequired- BIS area/series code identifying the country or aggregate.
api_tokenstring- Per-call token override. If omitted, env token is used.
areastring- Filter by BIS area.
fmtstring- 'json' or 'csv'. Default 'json'.default
json freqstring- Filter by frequency: 'Q' (quarterly) or 'A' (annual).
from_periodstring- Start of period range filter (e.g. '2023-Q1').
limitstring- Records per page (JSON capped at 250 rows; CSV up to 500).
offsetstring- Pagination offset.
property_typestring- Filter by property type (e.g. 'residential', 'commercial').
sortstring- Sort order for returned records.
to_periodstring- End of period range filter (e.g. '2024-Q4').
vintagestring- Filter by property vintage (e.g. 'existing', 'new').
eodhdmcp_get_real_estate_detailed_seriesList the BIS Detailed Property Price series available for a country.Read-onlyGet Real Estate Detailed Series
List the BIS Detailed Property Price series available for a country. Returns the complete upstream JSON envelope unchanged. Each ``data`` item describes its BIS dimensions and title; ``meta`` contains country and total. The catalogue is not paginated. Costs 5 API calls.
Inputs
codestringrequired- BIS area/series code identifying the country to list series for.
api_tokenstring- Per-call token override. If omitted, env token is used.
eodhdmcp_get_real_estate_selected_pricesFetch BIS Selected Property Prices for a country or aggregate.Read-onlyGet Real Estate Selected Prices
Fetch BIS Selected Property Prices for a country or aggregate. Supports nominal/real and index/year-over-year filters, quarterly period bounds, sorting, and upstream pagination. JSON preserves the full ``data``/``meta``/``links`` envelope; CSV returns plain text. Costs 5 calls.
Inputs
codestringrequired- BIS area/series code identifying the country or aggregate.
api_tokenstring- Per-call token override. If omitted, env token is used.
fmtstring- 'json' or 'csv'. Default 'json'.default
json from_periodstring- Start of period range filter (quarterly, e.g. '2023-Q1').
limitstring- Records per page.
metricstring- Metric: 'index' or 'yoy' (year-over-year).
offsetstring- Pagination offset.
sortstring- Sort order for returned records.
to_periodstring- End of period range filter (quarterly, e.g. '2024-Q4').
typestring- Price type: 'nominal' or 'real'.
eodhdmcp_get_sanctions_entitiesSearch sanctioned entities (e.g.Read-onlyGet Sanctions Entities
Search sanctioned entities (e.g. OFAC). Use when the user asks about sanctioned individuals, companies, vessels, or aircraft, OFAC SDN listings, or entities under a specific sanctions program. Returns sanctioned entities with aliases, identifiers, programs, and listing status. Filterable by source, entity type, program, country, free-text query, and active status. Paginated.
Inputs
activestring- Filter by active listing status.
api_tokenstring- Per-call token override.
countrystring- Country.
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
programstring- Sanctions program.
qstring- Free-text search (minimum 2 characters).
sourcestring- Data source (e.g. 'ofac').
typestring- Entity type: 'individual', 'entity', 'vessel', or 'aircraft'.
eodhdmcp_get_sanctions_programsList sanctions programs with entity counts.Read-onlyGet Sanctions Programs
List sanctions programs with entity counts. Use when the user asks which sanctions programs exist, how many entities are under each program, or wants to browse available programs. Returns each sanctions program and the number of entities listed under it. Paginated.
Inputs
api_tokenstring- Per-call token override.
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
eodhdmcp_get_sanctions_sourcesList available sanctions data sources.Read-onlyGet Sanctions Sources
List available sanctions data sources. Use when the user asks which sanctions lists or sources are available (e.g. OFAC), or wants to discover valid values for the 'source' parameter on other sanctions tools. Returns the available sanctions sources. Paginated.
Inputs
api_tokenstring- Per-call token override.
fmtstring- 'json' or 'csv'. Default 'json'.default
json limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
eodhdmcp_get_sanctions_vesselsSearch sanctioned vessels (e.g.Read-onlyGet Sanctions Vessels
Search sanctioned vessels (e.g. OFAC). Use when the user asks about sanctioned ships, vessels under sanctions, or vessel details by IMO number, flag, or type. Returns sanctioned vessels with identifiers (IMO, MMSI, call sign), flag, tonnage, owner, and program context. Filterable by source, IMO, flag, vessel type, free-text query, and program. Paginated.
Inputs
api_tokenstring- Per-call token override.
flagstring- Flag state.
fmtstring- 'json' or 'csv'. Default 'json'.default
json imostring- IMO number.
limitstring- Records per page (default 20, max 100).
offsetstring- Pagination offset.
programstring- Sanctions program.
qstring- Free-text search (minimum 2 characters).
sourcestring- Data source (e.g. 'ofac').
vessel_typestring- Vessel type.
eodhdmcp_get_sentiment_dataGet aggregated sentiment scores for stocks based on news and social media analysis.Read-onlyGet Sentiment Data
Get aggregated sentiment scores for stocks based on news and social media analysis. Returns daily sentiment polarity, news buzz, and weighted scores for one or more tickers over a date range. Use when analyzing market mood, news impact, or sentiment-driven trading signals. For raw news articles, use get_company_news instead. For word frequency in news, use get_news_word_weights instead.
Inputs
symbolsstringrequired- One or more comma-separated tickers (e.g., 'AAPL.US,BTC-USD.CC').
api_tokenstring- Per-call override; env token used if omitted.
end_datestring- YYYY-MM-DD, maps to 'to'.
fmtstring- 'json' (default). (XML not documented for this endpoint.)default
json start_datestring- YYYY-MM-DD, maps to 'from'.
eodhdmcp_get_stock_market_logosGet a company logo in PNG format (200x200 with transparency).Read-onlyGet Stock Market Logos
Get a company logo in PNG format (200x200 with transparency). Use when the user needs a raster logo image for a stock or company for display, reports, or UI. Covers 40,000+ logos across 60+ exchanges. Costs 10 API calls per request. Symbol must be in TICKER.EXCHANGE format (e.g., 'AAPL.US', 'BMW.XETRA'). For vector/SVG logos (US and Toronto only), use get_stock_market_logos_svg instead.
Inputs
symbolstringrequired- Ticker in TICKER.EXCHANGE format (e.g. 'AAPL.US', 'BMW.XETRA').
api_tokenstring- Per-call token override.
eodhdmcp_get_stock_market_logos_svgGet a company logo in SVG vector format.Read-onlyGet Stock Market Logos Svg
Get a company logo in SVG vector format. Use when the user needs a scalable vector logo for high-quality rendering, web embedding, or print. Limited to US and TO (Toronto) exchanges only. Costs 10 API calls per request. Symbol must be in TICKER.EXCHANGE format (e.g., 'AAPL.US', 'RY.TO'). For PNG logos with broader exchange coverage (60+ exchanges), use get_stock_market_logos.
Inputs
symbolstringrequired- Ticker in TICKER.EXCHANGE format (e.g. 'AAPL.US', 'RY.TO').
api_tokenstring- Per-call token override.
eodhdmcp_get_stocks_from_searchSearch for financial instruments by name, ticker, or ISIN.Read-onlyGet Stocks From Search
Search for financial instruments by name, ticker, or ISIN. Use when the user wants to find a ticker symbol, look up a company by name, resolve an ISIN, or discover instruments matching a keyword. Searches across stocks, ETFs, mutual funds, bonds, indices, and crypto. Returns matching instruments with their ticker codes, exchange, type, and ISIN. Filterable by exchange and instrument type. This is the discovery/lookup tool. Once you have a ticker, use other tools (e.g., get_eod_historical_data, get_fundamentals_data) to fetch actual data.
Inputs
querystringrequired- Ticker, company name, or ISIN to search (e.g., 'AAPL', 'Apple Inc', 'US0378331005').
api_tokenstring- Per-call API token override (demo token does NOT work for Search).
bonds_onlystring- If True, return only bonds.
exchangestring- Exchange code filter (e.g., 'US', 'PA', 'FOREX', 'NYSE').
fmtstring- Must be 'json'.default
json limitinteger- Number of results (default 15, max 500).default
15 typestring- One of {'all','stock','etf','fund','bond','index','crypto'}.
eodhdmcp_get_support_resistance_levelsCalculate pivot-point-based support and resistance levels for any stock, ETF, index, or crypto.Read-onlyGet Support Resistance Levels
Calculate pivot-point-based support and resistance levels for any stock, ETF, index, or crypto. Fetches historical OHLCV data and computes support/resistance levels using one of five standard pivot point methods: Classic (Floor), Fibonacci, Woodie, Camarilla, or DeMark. Each record in the result corresponds to one bar from the price history, with the calculated levels that traders use to identify potential reversal zones, entry/exit points, and stop-loss placement.
Inputs
tickerstringrequired- Symbol in SYMBOL.EXCHANGE format (e.g. 'AAPL.US'). If you only have a company name or ISIN, call resolve_ticker first.
api_tokenstring- Override API token for this call (optional).
end_datestring- End date in YYYY-MM-DD format (optional).
methodstring- Pivot point method â 'classic', 'fibonacci', 'woodie', 'camarilla', or 'demark'. Default 'classic'.default
classic periodstring- Price bar period â 'd' (daily), 'w' (weekly), 'm' (monthly). Default 'd'.default
d start_datestring- Start date in YYYY-MM-DD format (optional).
eodhdmcp_get_symbol_change_historyGet ticker symbol change history -- tracks when US stocks changed their ticker symbol or company name.Read-onlyGet Symbol Change History
Get ticker symbol change history -- tracks when US stocks changed their ticker symbol or company name. Returns old symbol, new symbol, company name, exchange, and effective date. Data available from 2022-07-22, US exchanges only. Use when the user asks about ticker renames, symbol changes, rebranding events, or needs to map old tickers to new ones. This is the only tool for symbol/ticker change tracking.
Inputs
api_tokenstring- Per-call token override; env token used if omitted.
end_datestring- 'to' in YYYY-MM-DD (e.g., '2022-11-01').
fmtstring- 'json' (default).default
json start_datestring- 'from' in YYYY-MM-DD (e.g., '2022-10-01').
eodhdmcp_get_technical_indicatorsCompute technical indicators for any ticker over a date range.Read-onlyGet Technical Indicators
Compute technical indicators for any ticker over a date range. Supported indicators: SMA, EMA, WMA, MACD, RSI, Stochastic, StochRSI, DMI/ADX, ATR, CCI, Parabolic SAR, Beta, Bollinger Bands, Volatility, Average Volume, and split-adjusted prices. Each indicator has configurable periods, and results include a time series of computed values. Consumes 5 API calls per request. For raw OHLCV price data, use get_historical_stock_prices instead. For fundamental analysis, use get_fundamentals_data instead. Returns: Array of objects, each with 'date' (str, YYYY-MM-DD) plus indicator-specific fields: - sma/ema/wma: {sma|ema|wma} (float) - rsi: {rsi} (float, 0-100) - macd: {macd, macd_signal, macd_hist} (float) - stochastic: {slow_k, slow_d} (float) - stochrsi: {stochrsi} (float) - bbands: {uband, mband, lband} (float â upper/middle/lower) - atr: {atr} (float) - adx: {adx} (float) - dmi: {dmi} (float) - cci: {cci} (float) - sar: {sar} (float) - beta: {beta} (float) - volatility: {volatility} (float) - avgvol: {avgvol} (int) - avgvolccy: {avgvolccy} (float â volume * close) - splitadjusted: {open, high, low, close, volume} (split-adjusted OHLCV) - stddev: {stddev} (float) - slope: {slope} (float) If filter is set (e.g. 'last_sma'), returns a single scalar value. Examples: "50-day SMA for Apple in 2025" â ticker="AAPL.US", function="sma", period=50, start_date="2025-01-01", end_date="2025-12-31" "RSI(14) for Bitcoin last 3 months" â ticker="BTC-USD.CC", function="rsi", period=14, start_date="2025-12-06" "MACD for Siemens with custom periods" â ticker="SIE.XETRA", function="macd", fast_period=12, slow_period=26, signal_period=9 Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
functionstringrequired- No description.
tickerstringrequired- No description.
accelerationstring- No description.
agg_periodstring- No description.
api_tokenstring- No description.
code2string- No description.
end_datestring- No description.
fast_dperiodstring- No description.
fast_kperiodstring- No description.
fast_periodstring- No description.
filterstring- No description.
fmtstring- No description.default
json maximumstring- No description.
orderstring- No description.default
a periodstring- No description.
signal_periodstring- No description.
slow_dperiodstring- No description.
slow_kperiodstring- No description.
slow_periodstring- No description.
splitadjusted_onlystring- No description.
start_datestring- No description.
eodhdmcp_get_upcoming_dividendsGet historical and upcoming dividend payments for stocks.Read-onlyGet Upcoming Dividends
Get historical and upcoming dividend payments for stocks. Returns ex-dividend dates, payment dates, dividend amounts, and currency for a given symbol or date. Requires at least one of 'symbol' or 'date_eq'. Supports date range filtering and pagination. Use when the user asks about dividend dates, payout history, yield data, or ex-dividend calendars. For IPO calendar, use get_upcoming_ipos. For stock splits calendar, use get_upcoming_splits. Returns: Array of dividend records, each with: - code (str): ticker symbol - exchange (str): exchange code - date (str): ex-dividend date - declarationDate (str): declaration date - recordDate (str): record date - paymentDate (str): payment date - period (str): frequency (e.g. 'Quarterly', 'Annual') - value (float): adjusted dividend per share - unadjustedValue (float): unadjusted dividend per share - currency (str): dividend currency Examples: "Apple dividends in 2025" â symbol="AAPL.US", date_from="2025-01-01", date_to="2025-12-31" "All dividends on March 15" â date_eq="2026-03-15" "Microsoft dividends this quarter" â symbol="MSFT.US", date_from="2026-01-01", date_to="2026-03-31" Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
api_tokenstring- No description.
date_eqstring- No description.
date_fromstring- No description.
date_tostring- No description.
fmtstring- No description.default
json page_limitstring- No description.
page_offsetstring- No description.
symbolstring- No description.
eodhdmcp_get_upcoming_earningsGet upcoming and recent earnings report dates for stocks.Read-onlyGet Upcoming Earnings
Get upcoming and recent earnings report dates for stocks. Returns scheduled earnings dates, EPS estimates, and actual results when available. Filter by specific symbols or a date range (defaults to next 7 days). Use when the user asks "when does X report earnings?" or wants an earnings calendar. For EPS/revenue trend analysis and analyst revisions, use get_earnings_trends instead. For macroeconomic events (GDP, CPI), use get_economic_events instead. Returns: Object with: - earnings (list): array of earning records, each with: - code (str): ticker symbol - report_date (str): report filing date - date (str): earnings date - before_after_market (str|null): 'BeforeMarket' or 'AfterMarket' - currency (str): reporting currency - actual (float|null): actual EPS - estimate (float|null): consensus EPS estimate - difference (float|null): actual minus estimate - surprise_prc (float|null): surprise percentage Examples: "Apple earnings schedule" â symbols="AAPL.US" "Earnings this week" â start_date="2026-03-02", end_date="2026-03-06" "Microsoft and Google earnings" â symbols="MSFT.US,GOOG.US" Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
api_tokenstring- No description.
end_datestring- No description.
fmtstring- No description.default
json start_datestring- No description.
symbolsstring- No description.
eodhdmcp_get_upcoming_iposGet upcoming and recent IPO (Initial Public Offering) listings.Read-onlyGet Upcoming Ipos
Get upcoming and recent IPO (Initial Public Offering) listings. Returns IPO dates, company names, exchanges, share prices, and deal details within a date range (defaults to next 7 days). Use when the user asks about new stock listings, companies going public, or IPO calendar. For stock splits calendar, use get_upcoming_splits. For dividend calendar, use get_upcoming_dividends. Returns: Object with: - ipos (list): array of IPO records, each with: - code (str): ticker symbol - name (str): company name - exchange (str): exchange code - currency (str): pricing currency - start_date (str): expected IPO date - filing_date (str): SEC filing date - amended_date (str): last amendment date - price_from (float|null): low end of price range - price_to (float|null): high end of price range - offer_price (float|null): final offer price - shares (int|null): shares offered - deal_type (str): type of offering (e.g. 'Priced') Examples: "IPOs this week" â from_date="2026-03-02", to_date="2026-03-06" "IPOs in March 2026" â from_date="2026-03-01", to_date="2026-03-31" "Upcoming IPOs next 30 days" â from_date="2026-03-06", to_date="2026-04-05" Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json from_datestring- No description.
to_datestring- No description.
eodhdmcp_get_upcoming_splitsGet upcoming and recent stock split events.Read-onlyGet Upcoming Splits
Get upcoming and recent stock split events. Returns split dates, tickers, and split ratios (e.g., 4:1) within a date range (defaults to next 7 days). Use when the user asks about stock splits, share splits, or reverse splits. For IPO calendar, use get_upcoming_ipos. For dividend calendar, use get_upcoming_dividends. Returns: Array of split records, each with: - code (str): ticker symbol - exchange (str): exchange code - optionable (str): whether options exist ('0' or '1') - date (str): split effective date - split (str): split ratio (e.g. '4/1') - oldShares (int): pre-split share count - newShares (int): post-split share count Examples: "Stock splits this week" â from_date="2026-03-02", to_date="2026-03-06" "Splits in Q1 2026" â from_date="2026-01-01", to_date="2026-03-31" "Any splits next month" â from_date="2026-04-01", to_date="2026-04-30" Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json from_datestring- No description.
to_datestring- No description.
eodhdmcp_get_us_live_extended_quotesGet extended delayed quotes for US stocks with rich detail beyond basic live prices.Read-onlyGet Us Live Extended Quotes
Get extended delayed quotes for US stocks with rich detail beyond basic live prices. Returns last trade, bid/ask with sizes and event timestamps, rolling averages (50d/200d), 52-week high/low, market cap, EPS, PE ratio, dividend yield, and more per symbol. Supports batching multiple US tickers in one call. 1 API call per ticker. For non-US tickers or basic global live prices, use get_live_price_data instead. For historical end-of-day data, use get_historical_stock_prices instead.
Inputs
symbolsstringrequired- A single comma-separated string or a sequence of tickers (e.g., ["AAPL.US","TSLA.US"]).
api_tokenstring- Optional token; if omitted, env is used via make_request().
fmtstring- 'json' (default) or 'csv'.default
json page_limitstring- Optional page size; max 100.
page_offsetstring- Optional offset for pagination; must be >= 0.
eodhdmcp_get_us_options_contracts[Marketplace] Get available US options contracts (calls and puts) for a stock or ETF.Read-onlyGet Us Options Contracts
[Marketplace] Get available US options contracts (calls and puts) for a stock or ETF. Returns strike prices, expiration dates, and contract symbols for the specified underlying ticker. Supports filtering by expiration date range, strike range, trade time, and option type (put/call). Use to discover which options exist before fetching pricing with get_us_options_eod. For the list of all tickers that have options, use get_us_options_underlyings. Consumes 10 API calls per request. Returns: JSON object with: - meta: Pagination metadata. - data (array): Options contracts, each with: - contractName (str): Full OCC contract name. - contractSize (int): Contract size (typically 100). - currency (str): Currency code (e.g. 'USD'). - type (str): 'call' or 'put'. - lastTradeDateTime (str): Last trade timestamp. - strike (float): Strike price. - lastPrice (float): Last traded price. - bid (float): Current bid price. - ask (float): Current ask price. - volume (int): Trading volume. - openInterest (int): Open interest. - impliedVolatility (float): Implied volatility. - delta (float): Option delta. - gamma (float): Option gamma. - theta (float): Option theta. - vega (float): Option vega. - expirationDate (str): Expiration date YYYY-MM-DD. - daysBeforeExpiration (int): Days until expiration. - intrinsicValue (float): Intrinsic value. - links.next (str|null): URL for next page, null if last page. Examples: "AAPL options expiring this month" â underlying_symbol="AAPL", exp_date_from="2026-03-01", exp_date_to="2026-03-31" "SPY puts with strike between 400 and 450" â underlying_symbol="SPY", type="put", strike_from=400, strike_to=450 "TSLA call contracts expiring in June 2026, sorted by strike" â underlying_symbol="TSLA", type="call", exp_date_from="2026-06-01", exp_date_to="2026-06-30", sort="strike"
Inputs
api_tokenstring- No description.
contractstring- No description.
exp_date_eqstring- No description.
exp_date_fromstring- No description.
exp_date_tostring- No description.
fieldsstring- No description.
fmtstring- No description.default
json page_limitinteger- No description.default
1000 page_offsetinteger- No description.default
0 sortstring- No description.
strike_eqstring- No description.
strike_fromstring- No description.
strike_tostring- No description.
tradetime_eqstring- No description.
tradetime_fromstring- No description.
tradetime_tostring- No description.
typestring- No description.
underlying_symbolstring- No description.
eodhdmcp_get_us_options_eod[Marketplace] Fetch end-of-day pricing data for US options contracts.Read-onlyGet Us Options Eod
[Marketplace] Fetch end-of-day pricing data for US options contracts. Use when asked about options prices, Greeks, open interest, volume, or implied volatility for stock/ETF options. Returns OHLC, volume, open interest, and Greeks per contract per trading day. Supports filtering by underlying symbol, expiration, strike, type (put/call), and trade date range. First find available contracts with get_us_options_contracts, then fetch pricing here. For the list of optionable tickers, use get_us_options_underlyings. Consumes 10 API calls per request. Returns: JSON object with: - meta: Pagination metadata. - data (array): EOD options records per date, each containing: - options.CALLS (array): Call contracts with: - contractName (str): Full OCC contract name. - expirationDate (str): Expiration date YYYY-MM-DD. - strike (float): Strike price. - lastPrice (float): Last traded price. - bid (float): Bid price. - ask (float): Ask price. - change (float): Price change. - changePercent (float): Price change percentage. - volume (int): Trading volume. - openInterest (int): Open interest. - impliedVolatility (float): Implied volatility. - options.PUTS (array): Put contracts (same fields as CALLS). - links.next (str|null): URL for next page, null if last page. Examples: "AAPL end-of-day options for March 2026" â underlying_symbol="AAPL", tradetime_from="2026-03-01", tradetime_to="2026-03-31" "MSFT puts EOD data, strike 300-400" â underlying_symbol="MSFT", type="put", strike_from=300, strike_to=400 "NVDA calls expiring 2026-06-20, compact" â underlying_symbol="NVDA", type="call", exp_date_eq="2026-06-20", compact=True
Inputs
api_tokenstring- No description.
compactstring- No description.
contractstring- No description.
exp_date_eqstring- No description.
exp_date_fromstring- No description.
exp_date_tostring- No description.
fieldsstring- No description.
fmtstring- No description.default
json page_limitinteger- No description.default
1000 page_offsetinteger- No description.default
0 sortstring- No description.
strike_eqstring- No description.
strike_fromstring- No description.
strike_tostring- No description.
tradetime_eqstring- No description.
tradetime_fromstring- No description.
tradetime_tostring- No description.
typestring- No description.
underlying_symbolstring- No description.
eodhdmcp_get_us_options_underlyings[Marketplace] List all US stock and ETF ticker symbols that have listed options.Read-onlyGet Us Options Underlyings
[Marketplace] List all US stock and ETF ticker symbols that have listed options. Use to check whether a specific ticker has options data or to browse the full universe of optionable underlyings before querying contracts or EOD pricing. For available contracts on a specific ticker, use get_us_options_contracts. For options pricing data, use get_us_options_eod. Consumes 10 API calls per request. Returns: JSON object with: - meta (object): Contains total count, fields list, compact flag. - data (array of str): Ticker symbols that have options available (e.g. ['AAPL','MSFT',...]). - links.next (str|null): URL for next page, null if last page. Examples: "list all tickers that have options" â (no params) "which stocks have options available" â (no params)
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json page_limitstring- No description.
page_offsetstring- No description.
eodhdmcp_get_us_tick_dataFetch historical tick-level trade data for US equities.Read-onlyGet Us Tick Data
Fetch historical tick-level trade data for US equities. Use when the user needs individual trade records with exact timestamps, prices, volumes, and market venue identifiers at the finest granularity available. Returns individual trades (ticks) across all US venues for a given time range. Fields include timestamp (ms), price, shares, market, sub-market, sequence number. US stocks only. Costs 10 API calls per request. For real-time streaming ticks, use capture_realtime_ws instead. For daily/intraday OHLCV bars, use get_intraday_historical_data.
Inputs
from_timestampstringrequired- Start UNIX time in seconds (UTC).
tickerstringrequired- US ticker, e.g., 'AAPL' or 'AAPL.US'.
to_timestampstringrequired- End UNIX time in seconds (UTC).
api_tokenstring- Per-call token override.
fmtstring- 'json' (default) or 'csv'.default
json limitinteger- Max ticks to return (default 1000).default
1000
eodhdmcp_get_user_detailsRetrieve EODHD account details for the current API token.Read-onlyGet User Details
Retrieve EODHD account details for the current API token. Use when the user asks about their subscription plan, API usage, rate limits, or account information. Returns account holder name, email, subscription type, payment method, API requests consumed today, daily rate limit, and invite token. This is account metadata only -- does not return any financial market data.
Inputs
api_tokenstring- Per-call token override. If omitted, the env var EODHD_API_KEY is used.
eodhdmcp_get_ust_bill_ratesFetch daily US Treasury Bill rates (discount and coupon-equivalent yields).Read-onlyGet Ust Bill Rates
Fetch daily US Treasury Bill rates (discount and coupon-equivalent yields). Use when the user asks about T-bill rates, short-term government borrowing costs, or discount rates for Treasury bills. Returns daily rates for tenors: 4WK, 8WK, 13WK, 17WK, 26WK, 52WK. Fields include date, tenor, discount rate, coupon-equivalent yield, averages, maturity date, and CUSIP. Filterable by year. Costs 1 API call per request. For Treasury par yield curve rates (longer maturities up to 30Y), use get_ust_yield_rates.
Inputs
api_tokenstring- Per-call token override.
limitstring- Records per page.
offsetstring- Pagination offset.
yearstring- Filter by year (1900+). Defaults to current year.
eodhdmcp_get_ust_long_term_ratesFetch US Treasury long-term rate composites and averages.Read-onlyGet Ust Long Term Rates
Fetch US Treasury long-term rate composites and averages. Use when asked about 20-year bond constant maturity rates, long-term real rate averages, or extrapolation factors. Covers rate types: BC_20year, Over_10_Years, Real_Rate â combining daily long-term nominal rates with real long-term rate averages. For individual tenor yield curves use get_ust_yield_rates. For inflation-adjusted real yields use get_ust_real_yield_rates. For T-bill rates use get_ust_bill_rates. Consumes 1 API call per request.
Inputs
api_tokenstring- Per-call token override; env token used otherwise.
limitstring- Records per page.
offsetstring- Pagination offset.
yearstring- Filter by year (1900 to current+1). Defaults to current year.
eodhdmcp_get_ust_real_yield_ratesFetch US Treasury inflation-adjusted (real) yield curve rates.Read-onlyGet Ust Real Yield Rates
Fetch US Treasury inflation-adjusted (real) yield curve rates. Use when asked about TIPS yields, real interest rates, or inflation-adjusted Treasury returns. Covers 5Y, 7Y, 10Y, 20Y, 30Y tenors from the Daily Par Real Yield Curve. For nominal Treasury yields use get_ust_yield_rates. For T-bill discount rates use get_ust_bill_rates. For long-term rate averages (20Y+ composites) use get_ust_long_term_rates. Consumes 1 API call per request.
Inputs
api_tokenstring- Per-call token override; env token used otherwise.
limitstring- Records per page.
offsetstring- Pagination offset.
yearstring- Filter by year (1900 to current+1). Defaults to current year.
eodhdmcp_get_ust_yield_ratesFetch daily US Treasury par yield curve rates.Read-onlyGet Ust Yield Rates
Fetch daily US Treasury par yield curve rates. Use when the user asks about Treasury yields, the yield curve, government bond rates, or interest rates across maturities. Returns nominal par yield curve rates for tenors: 1M, 1.5M, 2M, 3M, 4M, 6M, 1Y, 2Y, 3Y, 5Y, 7Y, 10Y, 20Y, 30Y. Fields include date, tenor, and rate. Filterable by year. Costs 1 API call per request. For short-term T-bill discount/coupon rates (4WK-52WK), use get_ust_bill_rates instead.
Inputs
api_tokenstring- Per-call token override.
limitstring- Records per page.
offsetstring- Pagination offset.
yearstring- Filter by year (1900+). Defaults to current year.
eodhdmcp_stock_screenerScreen and filter stocks by fundamental and technical criteria.Read-onlyStock Screener
Screen and filter stocks by fundamental and technical criteria. Build custom queries using filters (e.g., market_cap > 1B, sector = Technology, P/E < 20) and signals (e.g., 200d_new_hi, 50d_new_lo, bookvalue_neg, wallstreetbull). Returns matching tickers with key metrics. Supports sorting, pagination (limit up to 100). Consumes 5 API calls per request. Use this tool for stock discovery, screening by fundamentals/technicals, and building watchlists. For detailed data on a specific ticker, use get_fundamentals_data instead.
Inputs
api_tokenstring- No description.
filtersstring- No description.
fmtstring- No description.
limitinteger- No description.default
50 offsetinteger- No description.default
0 signalsstring- No description.
sortstring- No description.
eodhdmcp_capture_realtime_wsCapture real-time streaming market data via WebSocket for a fixed time window.WriteCapture Realtime Ws
Capture real-time streaming market data via WebSocket for a fixed time window. Use when the user needs live tick-by-tick prices, real-time trades, bid/ask quotes, or streaming forex/crypto rates. Connects to EODHD WebSocket feeds (us_trades, us_quotes, forex, crypto), subscribes to specified symbols, collects messages for the given duration, then returns all captured data at once. Unlike get_live_price_data (REST snapshot), this streams continuous updates. For a single REST-based price snapshot, use get_live_price_data instead. For historical tick-level trade data (not real-time), use get_us_tick_data.
Inputs
feedstringrequired- One of {'us_trades','us_quotes','forex','crypto'}.
symbolsstringrequired- Single or comma-separated symbols, or a list. Returns:
api_tokenstring- No description.
connect_timeoutnumber- No description.default
15 duration_secondsinteger- No description.default
5 max_data_bytesinteger- No description.default
52428800 max_messagesstring- No description.
ping_intervalnumber- No description.default
20 ping_timeoutnumber- No description.default
20
eodhdmcp_mp_index_components[Marketplace] Get constituent stocks of a specific S&P or Dow Jones index, including historical component changes for major indices.WriteMp Index Components
[Marketplace] Get constituent stocks of a specific S&P or Dow Jones index, including historical component changes for major indices. Use when asked which stocks are in an index, or to track index rebalancing history. Requires the index symbol from mp_indices_list (e.g. GSPC.INDX for S&P 500). To browse available indices first, use mp_indices_list. Consumes 10 API calls per request.
Inputs
symbolstringrequired- No description.
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_mp_indices_list[Marketplace] List all available S&P and Dow Jones indices with end-of-day details.WriteMp Indices List
[Marketplace] List all available S&P and Dow Jones indices with end-of-day details. Use when asked to browse or enumerate major stock market indices, or to find an index symbol before fetching its components with mp_index_components. Covers 100+ indices including S&P 500, Dow Jones, and sector indices. For components/constituents of a specific index, use mp_index_components. Consumes 10 API calls per request.
Inputs
api_tokenstring- No description.
fmtstring- No description.default
json
eodhdmcp_resolve_tickerResolve a company name, partial ticker, or ISIN to SYMBOL.EXCHANGE format (and ISIN).WriteResolve Ticker
Resolve a company name, partial ticker, or ISIN to SYMBOL.EXCHANGE format (and ISIN). USE THIS FIRST when a user mentions a company by name instead of a ticker symbol, or when you need to obtain the ISIN for a company/ticker. Calls the EODHD Search API and returns the best match as SYMBOL.EXCHANGE plus ISIN. If ambiguous (multiple exchanges), returns top 10 matches for user selection.
Inputs
querystringrequired- Company name, partial ticker, or ISIN to resolve.
api_tokenstring- Per-call API token override.
asset_typestring- Filter by type: "stock", "etf", "fund", "bond", "index", "crypto".
preferred_exchangestring- Exchange code to prefer (e.g. "US", "XETRA", "LSE").
eodhdmcp_retrieve_description_by_idRetrieve built-in EODHD API documentation by numeric type and id.WriteRetrieve Description By Id
Retrieve built-in EODHD API documentation by numeric type and id. Use when the user asks about API usage, endpoint specs, subscription plans, or reference guides. Returns structured Markdown content for subscriptions (type=1), endpoint docs (type=2), or general reference (type=3). Call with type=0 or no args for the global README index. This is a local lookup â not an API data call. No API calls consumed.
Inputs
api_tokenstring- Ignored (accepted for interface uniformity).
idstring- Numeric page ID within the type. Optional; defaults to 0 (README for the given type).
typestring- Page category (0 = global README, 1 = subscriptions,
2 = endpoints, 3 = general). Default 0.default
0
No tools match.
