Skill: eodhd-api

Purpose

Use EODHD market data APIs to fetch, normalize, and summarize financial data including:

• Prices (historical, intraday, real-time)
• Company fundamentals and financial statements
• Options data with Greeks (from EODHD Marketplace)
• Technical indicators
• News and sentiment
• Macro-economic indicators
• Corporate events (dividends, splits, earnings, IPOs)
• US Treasury interest rates (bill rates, long-term rates, yield curves, real yield curves)
• ESG / environmental scores (from EODHD Marketplace — Investverte)
• Risk analytics and multi-factor reports (from EODHD Marketplace — PRAAMS)
• Bank financials and bond analysis (from EODHD Marketplace — PRAAMS)
• Tick-level market data (from EODHD Marketplace)
• Trading hours and market status (from EODHD Marketplace — TradingHours)

Supports equities, ETFs, indices, forex, crypto, and bonds across 70+ exchanges worldwide.

Trigger

Use this skill whenever the user's task involves financial data, markets, investing, or building financial tools. This includes — but is not limited to — the categories below.

Direct data requests

• End-of-day or historical stock/ETF/index/forex/crypto prices
• Intraday price bars (1m, 5m, 1h intervals)
• Real-time or delayed quotes, extended US quotes with bid/ask
• Company fundamentals, financials, valuation metrics, or financial ratios
• Options chains, Greeks, or options analytics (from EODHD Marketplace)
• Technical indicators (SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic, ADX, ATR, etc.)
• Company or market news, sentiment scores, trending topics
• Stock screening / filtering by fundamental or technical criteria
• Exchange listings, ticker search, or market metadata
• Macro-economic indicators (GDP, inflation, unemployment, interest rates, trade balance, etc.)
• Corporate calendar events (earnings, dividends, splits, IPOs)
• Insider trading activity (executive purchases, sales, SEC filings)
• ESG scores and environmental data — company, sector, country level (from EODHD Marketplace — Investverte)
• Risk scoring, volatility analytics, beta, risk/return profiles (from EODHD Marketplace — PRAAMS)
• Bank balance sheets, income statements, bond analysis (from EODHD Marketplace — PRAAMS)
• US Treasury rates (bill rates, long-term rates, yield curves, real yield curves)
• Historical market capitalisation
• Index composition and components
• Bulk data exports for an entire exchange
• Symbol change history and delisted tickers
• Trading hours, market status, and market holidays (from EODHD Marketplace — TradingHours)
• Company logos and branding assets

Endpoint support tiers — not all endpoints are equally reliable. Check references/general/support-matrix.md (generated from registry/capabilities.json) for the authoritative list:

• validated — call via the Python client (scripts/eodhd_client.py); covered by e2e tests.
• fallback — in the Python client but not e2e-verified; works, but verify the response.
• documented — marketplace add-ons (options, ESG/Investverte, PRAAMS, TradingHours, tick data); call via curl per the endpoint doc. Not in the Python client.

Building financial tools and applications

Activate this skill when the user is programming or designing any of:

• Stock screeners / scanners — filtering stocks by P/E, market cap, sector, growth, dividends, etc.
• Portfolio trackers — tracking holdings, calculating P&L, showing allocation
• Investment dashboards / panels — visualising market data, watchlists, sector heatmaps
• Trading systems / bots — algorithmic or rule-based strategies that need price feeds
• Backtesting engines — testing strategies against historical price and volume data
• Price alert / notification systems — monitoring price levels, volume spikes, or indicator crossovers
• Dividend trackers / income planners — modelling dividend income from a portfolio
• Earnings calendars / event trackers — upcoming earnings, IPOs, splits, economic releases
• Financial data pipelines / ETL — ingesting market data into databases, data warehouses, or analytics platforms
• Market data APIs or microservices — wrapping EODHD data for downstream consumers
• Charting / technical analysis tools — rendering candlestick charts, overlaying indicators
• Options analysis tools — payoff diagrams, implied volatility surfaces, Greeks dashboards
• Risk management tools — VaR calculators, portfolio risk decomposition, drawdown analysis
• Sector / industry analysis tools — comparing metrics across sectors or industries
• Financial reporting generators — producing PDF / HTML reports with market data
• Watchlist applications — letting users curate and monitor symbol lists
• Market data widgets or embeds — price tickers, mini-charts, quote cards for websites
• Robo-advisor prototypes — automated portfolio construction using fundamental and technical data
• Tax-loss harvesting helpers — identifying lots to sell, calculating wash-sale windows
• Crypto portfolio tools — tracking crypto alongside equities, forex, and bonds

Financial analysis, research, and advice

Activate this skill when the user is performing or asking for:

• Fundamental analysis — valuation (DCF, comparables), financial-statement review, ratio analysis
• Technical analysis — chart patterns, indicator interpretation, support/resistance, trend analysis
• Quantitative / statistical analysis — correlation, regression, factor models, Monte Carlo simulation using market data
• Risk assessment — portfolio volatility, beta, Sharpe ratio, maximum drawdown, Value at Risk
• Peer / competitive comparison — comparing financial metrics across a group of companies
• Sector or industry research — analysing sector performance, rotation, relative strength
• Macro-economic research — linking GDP, inflation, or interest-rate data to market performance
• Event studies — measuring price impact around earnings, M&A announcements, policy changes
• Insider-activity analysis — tracking executive buying/selling as a signal
• ESG / sustainability research — screening by environmental or governance scores
• Dividend analysis — yield, payout ratio, growth rate, sustainability
• Earnings quality analysis — trends, surprises, revision momentum
• IPO research — upcoming offerings, sector trends, pricing
• Bond and fixed-income analysis — yield curves, duration, credit spread trends
• Currency / forex analysis — exchange-rate trends, carry-trade research
• Investment advice or recommendations — when the user asks "what should I invest in?", "is X a good buy?", or similar questions that benefit from real market data
• Portfolio allocation or rebalancing — constructing or adjusting a portfolio using current and historical data
• Retirement or financial planning — modelling scenarios that reference market returns, inflation, interest rates
• Academic or educational projects — coursework, papers, or tutorials that need real market data

Required inputs

• API key — the EODHD_API_TOKEN environment variable. If it is not set, ask the user to provide their API key interactively. Once received, export it in the current shell session (export EODHD_API_TOKEN="<key>"). The user can obtain a free or paid key at https://eodhd.com/. If the user is concerned the key may have been compromised, they can provide a new key at any time and the session variable will be updated.
• Instrument identifier in EODHD format: {TICKER}.{EXCHANGE} (e.g., AAPL.US, BMW.XETRA)
• Date range (--from-date, --to-date) for time-series requests
• Endpoint-specific parameters (e.g., --function for technical indicators)

Workflow

1. Clarify the request
   • Check that EODHD_API_TOKEN is set; if not, ask the user for their key and export it
   • Identify objective: price