# EOD Historical Data MCP > EOD Historical Data provides access to professional-grade financial market data through a single API connection. You can pull everything from daily and minute-by-minute historical prices for stocks, ETFs, and commodities, to deep company fundamentals (like P/E ratios and balance sheets), insider trading reports, and US Treasury rates. It’s the central hub for any serious quantitative analysis. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** stock-market, financial-data, historical-prices, fundamental-analysis, trading-tools ## Description You connect this MCP to your AI agent, and it becomes a massive data library accessible through natural conversation. Instead of logging into three different vendor portals—one for price history, one for corporate filings, and another for macroeconomic indicators—you ask your agent to pull everything at once. You can track historical trends using End-Of-Day data, or zoom in on minute-by-minute action with intraday feeds. Need to check if a company's valuation changed after its latest earnings announcement? Just ask. The system pulls the fundamental ratios alongside the price movement and even tracks recent insider sales. This capability means you don’t just get numbers; you get context, allowing your agent to build out complex reports using data from multiple sources. Vinkius makes connecting this massive dataset effortless, letting any compatible AI client use it immediately. ## Tools ### get_bulk_fundamentals Gathers fundamental financial statements for groups of assets across an entire exchange. ### get_calendar_dividends Shows a schedule of upcoming dividend payments across various stocks. ### get_calendar_earnings Retrieves an organized calendar listing all expected company earnings dates. ### get_calendar_ipos Provides a list and schedule of upcoming Initial Public Offerings (IPOs). ### get_calendar_splits Lists dates for anticipated stock splits for specific companies. ### get_commodities Retrieves historical pricing data for raw commodities like oil or gold. ### get_dividends Gets a detailed history of dividend payments for any given stock symbol. ### get_eod_historical Fetches the daily End-Of-Day (EOD) price and volume data for a specified asset. ### get_exchange_symbol_list Pulls a complete list of all active stock tickers for a single exchange. ### get_exchanges_list Lists every supported financial market where you can pull data. ### get_fundamentals Retrieves the full set of financial metrics and statements for one specific asset. ### get_id_mapping Converts common identifiers (like CUSIP or ISIN) into usable stock tickers. ### get_insider_transactions Tracks and summarizes recent insider sales and purchases using SEC Form 4 filings. ### get_intraday_historical Gets granular, minute-by-minute historical price data for high-frequency analysis. ### get_news Pulls a general feed of the latest financial news headlines and articles. ### get_news_word_weights Calculates how often specific words are used in relation to a stock ticker across the news feed. ### get_real_time Provides live, delayed OHLCV data snapshots for immediate market monitoring. ### get_screener Filters the entire market to show only assets that meet specific financial criteria or signals. ### search_assets Finds any asset ticker by searching its name, ISIN, or common symbol. ### get_sentiments Determines the overall positive or negative emotional tone of recent news coverage for a stock. ### get_splits Retrieves the historical dates and ratios for any stock split events. ### get_technical_indicators Calculates common technical metrics, like RSI or MACD, based on price history. ### get_user Checks your personal account status and remaining API usage limits. ### get_ust_bill_rates Retrieves the current yield rates for US Treasury Bills (short-term debt). ### get_ust_real_yield_rates Provides the adjusted real yield rate for US Treasury bonds, factoring in inflation. ### get_ust_yield_rates Gets the current and historical yield rates for all US Treasury notes. ## Prompt Examples **Prompt:** ``` Get the historical EOD data for AAPL.US for the last 30 days. ``` **Response:** ``` I've retrieved the EOD historical data for Apple Inc. (AAPL) on the US exchange. Over the last 30 days, the price moved from $185.20 to $192.45 with an average daily volume of 55M shares. ``` **Prompt:** ``` Show me the fundamental data and key ratios for TSLA.US. ``` **Response:** ``` Fetching fundamentals for Tesla... I have the latest balance sheet and income statement. Key metrics include a P/E Ratio of 45.2, Debt-to-Equity of 0.12, and a Profit Margin of 14.5%. Would you like to see the full cash flow statement? ``` **Prompt:** ``` What are the latest insider transactions for Microsoft (MSFT.US)? ``` **Response:** ``` I found 3 recent insider transactions for MSFT. The most notable was a sale of 10,000 shares by a Senior VP on 2023-10-15 at an average price of $330.10. Two other directors exercised options earlier this month. ``` ## Capabilities ### Calculate historical price movements Retrieve daily, weekly, or minute-by-minute OHLCV data for nearly every global market. ### Analyze corporate health metrics Pull key financial statements and ratios, including balance sheets and income statements, directly into your analysis. ### Monitor insider trading activity Track public filings (SEC Form 4) to see who is buying or selling shares at the executive level. ### Model macro-economic shifts Fetch current and historical US Treasury bill, yield, and real yield rates for large-scale modeling. ### Identify market opportunities Screen the entire stock market based on specific financial metrics or technical signals to find undervalued assets. ## Use Cases ### Validating an investment thesis for a tech stock. A portfolio manager asks their agent: 'Compare the current P/E ratio for MSFT against its average over the last three years. Did recent insider activity, captured by `get_insider_transactions`, change that trend?' The agent pulls fundamentals and transactions to give one answer. ### Building a backtesting model. A developer needs clean data for 10 years. They use the MCP's ability to pull `get_intraday_historical` data across multiple symbols, feeding it directly into their code environment. ### Assessing sector rotation risk. A quant analyst wants to know if commodities are outperforming tech. They query the agent to pull `get_commodities` historical prices and compare that trend against a major tech index's EOD performance. ### Checking for upcoming market catalysts. A trader asks: 'What is coming up next month?' The agent checks the calendar tools, pulling data from `get_calendar_earnings` and `get_calendar_dividends` to build a single timeline of key events. ## Benefits - You stop jumping between vendors. By connecting this MCP, you centralize data—from getting the latest `get_fundamentals` for a company to pulling its full historical price path using `get_eod_historical`. - Macro views are simple. You can check systemic risk by running comparisons between corporate valuation (using `get_fundamentals`) and current US Treasury rates via `get_ust_yield_rates` in one prompt. - Forecasting is easier. Instead of guessing, you let your agent combine signals: reading the positive mood from `get_sentiments`, checking if those gains are supported by recent earnings (`get_calendar_earnings`), and seeing how it played out on a minute-by-minute basis with `get_intraday_historical`. - Risk checks become automatic. You can use the market screener tool, `get_screener`, to filter assets based on multiple criteria—like high volume *and* low P/E ratio—instantly finding undervalued plays. - Compliance tracking is simple. Need to know if executives bought or sold? Running a query with `get_insider_transactions` gives you immediate access to Form 4 data, saving hours of manual SEC filing review. ## How It Works The bottom line is: you talk to your AI client, and it does the heavy lifting of compiling data from dozens of global exchanges into one actionable report. 1. Subscribe to this MCP and provide your EODHD API Token. 2. Connect your preferred AI client through Vinkius, granting it access to the data tools. 3. Ask your agent a complex financial question (e.g., 'Compare AAPL's P/E ratio against its 52-week average') for an instant, synthesized answer. ## Frequently Asked Questions **How do I get historical data for multiple assets using the get_eod_historical tool?** You instruct your agent to loop through a list of symbols. The MCP can then process and retrieve EOD historical data for all those tickers in sequence, giving you a comparative view. **Can I use get_fundamentals to check for company debt?** Yes. `get_fundamentals` provides the full financial statements. You can specifically ask it to pull metrics like Debt-to-Equity or Total Liabilities, which is key for assessing risk. **What kind of data does get_intraday_historical provide?** `get_intraday_historical` provides minute-by-minute price data. This is useful when you need to analyze short-term volatility, unlike the daily summaries from `get_eod_historical`. **How do I find out what a ticker symbol is?** You use `search_assets`. You can search by name or ISIN, and the tool resolves it to give you the official ticker symbol needed for all other functions. **I need to check my API limits. How do I monitor my usage and available calls using the `get_user` tool?** The `get_user` tool provides your account details, including current usage metrics and rate limit information. It's essential for planning large data pulls and avoiding service interruptions. **I only have an ISIN or CUSIP number, not a ticker. How do I find the correct symbol using `get_id_mapping`?** The `get_id_mapping` tool resolves various identifiers like CUSIP, ISIN, and FIGI into actionable exchange symbols. This lets you use your existing data to pull historical prices or fundamentals. **Can I retrieve historical price data for commodities that aren't stocks? What does `get_commodities` do?** `get_commodities` fetches the historical pricing information for various commodity markets. This tool expands your analysis beyond traditional equities, covering goods like gold or oil. **If I need to compare metrics across an entire exchange, how should I use `get_bulk_fundamentals`?** `get_bulk_fundamentals` retrieves fundamental data for multiple symbols from a specified exchange. Use this when you need to analyze the financial health of many companies in one go. **How can I retrieve historical price data for a specific stock?** Use the `get_eod_historical` tool by providing the ticker symbol and exchange (e.g., AAPL.US). You can specify the date range and period (daily, weekly, or monthly) to get adjusted OHLCV data. **Can I access company financial statements and fundamental ratios?** Yes! The `get_fundamentals` tool provides comprehensive data including balance sheets, income statements, cash flows, and key ratios for stocks and ETFs globally. **How do I check my current API usage and subscription limits?** Simply use the `get_user` tool. It will return your account details, current API usage statistics, and daily rate limits associated with your token.