EODHD APIs
EODHD APIs provide comprehensive financial data, including historical stock market data, live stock prices, fundamental data, and more, accessible via REST and WebSocket APIs.
Verdict
Common use cases
- Pull GDP growth rates for investment thesis
- Compare mutual fund returns across quarters
- Monitor forex pairs during trading hours
- Stream live US equity trades for watchlist
- Enrich research notes with macro indicators
Integration
- Vendor
- EODHD APIs
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 4
- Composio slug
eodhd_apis
Tools
- Get Macro Indicators
Tool to retrieve macroeconomic indicators data. use when you need country-level economic indicators across a date range. use after confirming the api token is set.
- Get Mutual Funds Data
Tool to retrieve mutual funds data for a specified symbol. use after confirming the mutual fund ticker symbol.
- Get Real-Time FOREX WebSocket Stream
Tool to retrieve real-time data for forex via websocket. use when you need live price updates for specific currency pairs.
- Get Real-time WebSocket US Trades
Tool to retrieve real-time trade data for the us market via websocket. use when live updates for specific us symbols are required. example: subscribe to ['aapl', 'goog'].
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find EODHD APIs in the MCP directory and click Connect. 3. Visit eodhd.com, sign in to your account, and copy your API token from the dashboard. 4. Paste the token into the API Key field in Switchy and click Save. 5. Return to any Space, type '@EODHD get mutual funds data for VFIAX' and send the message. 6. If the MCP responds with fund details, the connection is live. 7. To test real-time data, try '@EODHD get real-time forex stream for EUR/USD' — the stream will push updates until you stop it or close the Space. 8. Check your EODHD plan limits if you see rate errors; some endpoints require a paid subscription.
What teammates see: by default, memories from EODHD APIs are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
GDP Trends Last Year
@EODHD get macro indicators for the United States, indicator GDP, from 2023-01-01 to 2023-12-31Open in a Space →
Mutual Fund Snapshot
@EODHD get mutual funds data for VTSAX and summarize its top 10 holdings and year-to-date returnOpen in a Space →
Live EUR/USD Feed
@EODHD get real-time forex stream for EUR/USD and alert me if the rate crosses 1.10Open in a Space →
US Stock Trades Stream
@EODHD get real-time US trades for AAPL and TSLA, then flag any trade over 10,000 sharesOpen in a Space →
Inflation Check
@EODHD get macro indicators for Germany, indicator CPI, from 2022-01-01 to 2024-01-01Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@EODHD APIs show me US GDP growth, unemployment rate, and inflation for the last 4 quarters
Here's an illustrative summary of US macroeconomic indicators for Q1 2024 through Q4 2024: GDP growth averaged 2.3% (ranging 1.9%-2.8% quarterly), unemployment held steady between 3.7%-4.1%, and CPI inflation declined from 3.2% to 2.6% over the period. This data reflects the Federal Reserve's tightening cycle impact on both growth and price stability. The MCP returned quarterly snapshots with exact dates and values for each indicator.
This example demonstrates the Get Macro Indicators tool's ability to fetch country-level economic data across time ranges. Requires a valid EODHD API key with macro data access. Response structure and available indicators vary by country and subscription tier—some emerging markets have sparser historical coverage.
@EODHD APIs what's the current NAV, expense ratio, and top 5 holdings for VFIAX?
For VFIAX (Vanguard 500 Index Fund Admiral Shares), the illustrative response shows: NAV $428.51 as of last close, expense ratio 0.04%, and top holdings include AAPL (7.1%), MSFT (6.8%), AMZN (3.4%), NVDA (3.2%), and GOOGL (2.1%). The MCP also returned fund inception date, total assets under management, and year-to-date return. This data helps compare fund costs and concentration risk across portfolio candidates.
Showcases the Get Mutual Funds Data tool for retrieving fund fundamentals by ticker symbol. You must provide the correct mutual fund ticker—equity tickers won't work here. Data freshness depends on the fund's reporting schedule; NAV updates daily but holdings typically refresh quarterly.
@EODHD APIs stream live EUR/USD and GBP/USD prices, then alert me if EUR/USD drops below 1.0800
Illustrative WebSocket stream initiated for EUR/USD and GBP/USD. Live tick data flows in with bid/ask spreads and timestamps: EUR/USD currently 1.0823/1.0825, GBP/USD 1.2645/1.2647. The AI monitors the stream and would trigger an alert if EUR/USD bid falls below your 1.0800 threshold. This real-time feed enables event-driven workflows—like notifying a team channel when a currency pair breaches a technical level or updating a dashboard with sub-second latency.
Demonstrates the Get Real-Time FOREX WebSocket Stream tool for live currency pair monitoring. WebSocket connections consume API quota differently than REST calls—check your plan's concurrent stream limits. The AI can layer logic on top of the raw feed (thresholds, pattern detection), but you're responsible for managing connection lifecycle and reconnection logic if the stream drops.
Use-case deep-dives
When real-time WebSocket streams beat polling for user dashboards
A 6-person fintech startup building a portfolio tracker needs live US equity and forex prices without hammering rate limits. The EODHD MCP's WebSocket tools (US trades and forex streams) let you subscribe to specific symbols once and push updates to your dashboard as they arrive, instead of polling REST endpoints every few seconds. This works cleanly for up to 50-100 concurrent symbols—enough for most retail portfolio apps. If your user base watches 500+ tickers simultaneously or needs sub-second latency guarantees, you'll hit connection limits and need a dedicated market data vendor. For small-team MVPs tracking a handful of assets per user, the WebSocket approach keeps your API costs low and your dashboard responsive without custom streaming infrastructure.
Pull country-level economic data into analyst workflows without spreadsheet exports
A 3-person investment research shop writes weekly market commentary and needs GDP, inflation, and unemployment figures for 10-15 countries. The Get Macro Indicators tool pulls this data directly into Switchy threads, so analysts can compare indicators across date ranges without downloading CSVs or toggling between FRED and Trading Economics tabs. The tool returns structured JSON, which means you can pipe it into charts or summary prompts in the same workspace. This setup breaks down if you need sub-national data (state-level unemployment) or non-standard indicators—EODHD's macro coverage is broad but not exhaustive. For small teams writing reports that cite standard economic metrics, this MCP eliminates the export-paste-cite loop and keeps your data provenance in one thread.
When you need fund NAV history but don't need Bloomberg-level depth
A 2-person RIA firm compares mutual fund performance for client portfolios and needs historical NAV data without paying for institutional terminals. The Get Mutual Funds Data tool fetches time-series NAV, expense ratios, and holdings for US mutual funds by ticker, which covers 90% of retail fund comparisons. You can pull data for 5-10 funds in a single Switchy session and generate side-by-side performance tables without leaving the workspace. This falls short if you need real-time intraday NAV updates (most funds publish once daily) or obscure international funds outside EODHD's coverage. For small advisory teams running quarterly reviews with standard Vanguard, Fidelity, or Schwab funds, this MCP gives you the data layer without the $2k/month terminal cost.
Frequently asked
What does the EODHD APIs MCP do in Switchy?
It connects Switchy to EODHD's financial data feeds — macroeconomic indicators, mutual fund prices, and real-time forex or US equity trades via WebSocket. Your AI can pull country-level GDP or inflation data, look up fund tickers, or subscribe to live price streams for currency pairs and stocks without writing API code.
Do I need a paid EODHD account to use this MCP?
Yes. You need an active EODHD subscription and an API key. Free-tier keys exist but typically have rate limits and delayed data. The MCP stores your key in Switchy's credential vault; you paste it once during setup, and every tool call authenticates automatically.
Can the EODHD MCP execute trades or manage portfolios?
No. It only reads market data — prices, indicators, fund details. If you want to place orders or rebalance holdings, you'll need a separate brokerage integration or use EODHD's data to inform manual trades. Think of this as a research feed, not a trading desk.
How does this compare to pulling EODHD data via REST API?
The MCP wraps EODHD's REST endpoints and WebSocket streams so your AI can request data in plain English. You skip writing fetch loops, parsing JSON, and managing socket reconnects. For one-off queries or prototypes it's faster; for high-frequency pipelines a direct API integration still makes sense.
Who on the team should connect the EODHD MCP?
Whoever holds the EODHD API key — typically a quant analyst, data engineer, or finance lead. They paste the key once in Switchy; after that any team member can ask the AI for macro data or live forex quotes without needing their own EODHD login.