canonical: https://jentic.com/apis/eodhd.com/eodhd

# EODHD Financial Data API

Jentic publishes the only available OpenAPI specification for EODHD Financial Data API, keeping it validated and agent-ready. EODHD provides end-of-day prices, intraday data, fundamentals, dividends, splits, earnings calendars, news with sentiment, screening, technical indicators, macroeconomic indicators, and ESG data across more than 70 stock exchanges. The API exposes 68 REST endpoints organised around price history, company fundamentals, calendar events, screening, and reference data so agents can pull market data on demand. Authentication is by API token passed as a query parameter, and most responses are JSON suitable for downstream analysis.

## For AI agents

Pull historical and real-time stock prices, fundamentals, news sentiment, and macro indicators for thousands of tickers across 70+ exchanges. Authenticate with a single api_token query parameter.

## Scope

Does not handle order execution, brokerage account management, or live tick streaming over websockets - use for historical and reference financial data retrieval only.

## Capabilities

- Retrieve end-of-day OHLCV history for any ticker on a supported exchange
- Fetch company fundamentals including financial statements, ratios, and ESG scores
- Pull earnings, IPO, splits, and dividend calendars filtered by date range
- Run a screener over fundamentals and price metrics to surface tickers matching custom criteria
- Stream financial news with sentiment scores tied to specific tickers
- Calculate technical indicators (SMA, RSI, MACD) on historical price series
- Look up macroeconomic indicators by country for cross-asset analysis

## Use cases

### Quantitative Backtesting Data Pipeline

Quant researchers and trading bots need clean historical OHLCV plus corporate actions to backtest strategies. EODHD covers over 70 exchanges with adjusted prices, dividends, and splits in a single normalised API, so an agent can populate a strategy database without per-vendor adapters. Universe sweeps run in minutes once the api_token is loaded.

Example prompt: Fetch 10 years of daily adjusted closes for the S&P 500 constituents via /eod/{ticker} and write the results to a parquet file.

### Fundamentals-Based Screening for Investment Research

Analysts running thematic or value screens need to filter the global equity universe by reported fundamentals. The /screener and /fundamentals endpoints let an agent combine valuation ratios, growth metrics, and ESG flags into a single ranked list of tickers, replacing manual exports from terminals.

Example prompt: Call /screener with filters market_cap>1e9, pe<12, dividend_yield>0.03 and return the top 50 results sorted by yield.

### News Sentiment Monitoring for a Watchlist

Portfolio managers track headline risk on holdings by aggregating sentiment-scored news. EODHD attaches sentiment polarity and magnitude to each article via /news and /sentiments, so an agent can flag tickers with sharp sentiment shifts and trigger alerts before price moves.

Example prompt: Pull the last 24 hours of news for tickers AAPL, MSFT, GOOG via /news and return any article with sentiment polarity below -0.5.

### AI Agent Market Data Tool via Jentic

An AI agent embedded in a finance copilot needs on-demand market data without bespoke client code. Through Jentic the agent searches for the EODHD operation by intent (for example 'get historical stock prices'), loads the schema, and executes the call with a vault-stored api_token. No SDK installation or per-endpoint integration is required.

Example prompt: Use Jentic search('get historical stock prices'), load the matching EODHD operation, and execute it for ticker TSLA.US over the last quarter.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /eod/{ticker} | End-of-day historical prices |
| GET | /fundamentals/{ticker} | Company fundamentals and financial statements |
| GET | /screener | Run a fundamentals and valuation screener |
| GET | /news | Financial news with sentiment scores |
| GET | /calendar/earnings | Upcoming earnings calendar |
| GET | /technical/{ticker} | Technical indicator series |
| GET | /macro-indicator/{country} | Macroeconomic indicators by country |
| GET | /exchange-symbol-list/{exchangeCode} | List symbols traded on an exchange |

## Key resources

- **Prices** — End-of-day, intraday, real-time delayed quotes, and tick data per ticker
- **Fundamentals** — Company financial statements, ratios, ESG scores, and bulk fundamentals per exchange
- **Calendar** — Earnings, IPOs, splits, dividends, and trends calendars
- **News & Sentiment** — News articles, sentiment polarity scores, and word weight analysis
- **Screener** — Filter equities by fundamentals, valuation, and price metrics
- **Macro & Economic** — Country-level macro indicators and economic event series
- **Reference Data** — Exchange lists, symbol lists, and identifier mappings

## Why Jentic

- **Setup:** Wiring EODHD by hand means appending its api_token as a query parameter on every request, learning which endpoint serves each data type, and building your own retries against eodhd.com/api. Through Jentic you install once, import the EODHD Financial Data API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** EODHD is read-only reference data, so scope the agent to the operations it needs, such as GET /eod/{ticker} or GET /fundamentals/{ticker}. You pick that allowed set, so an operation like the screener or news feed is only reachable if you include it.
- **Credential handling:** Your EODHD api_token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'historical stock prices' or 'company fundamentals', and Jentic returns the matching EODHD operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **U.S. EPA ECHO Clean Air Act** — ESG and environmental compliance data for U.S. facilities, useful alongside EODHD ESG fields
- **USDA ARMS Data API** — U.S. agricultural sector survey data for macro context on commodity-linked equities
- **Escrow.com API** — Escrow payments for high-value asset transfers - pairs with finance workflows

## FAQ

### Why is there no official OpenAPI spec for EODHD Financial Data API?

EODHD does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the EODHD Financial Data API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the EODHD Financial Data API use?

EODHD uses an apiKey scheme passed as the api_token query parameter on every request. Through Jentic the token is stored encrypted in your Jentic One instance, and agents receive a scoped reference rather than the raw token in their context.

### Can I pull historical end-of-day prices with the EODHD Financial Data API?

Yes. The GET /eod/{ticker} endpoint returns daily OHLCV history for a ticker on any of the 70+ supported exchanges, with adjustments for splits and dividends available via query parameters.

### What are the rate limits for the EODHD Financial Data API?

EODHD enforces per-plan request limits (commonly 1,000 to 100,000 calls per day depending on subscription) and a per-second cap. The OpenAPI spec does not encode these; check your plan dashboard at eodhd.com for the current numbers.

### How do I screen stocks by fundamentals through Jentic?

Search for the operation with query 'screen stocks by fundamentals'. Jentic returns the GET /screener operation, you load its schema, and execute with filter expressions on market_cap, pe, dividend_yield, and other fields. The scoped api_token is injected automatically.

### Can I get news sentiment for a specific ticker?

Yes. GET /news accepts a ticker filter and returns articles with sentiment polarity and magnitude attached. For aggregate sentiment series use GET /sentiments with the same ticker filter.

### Is the EODHD Financial Data API free?

EODHD offers a limited free tier for evaluation and paid subscriptions starting around USD 19.99/month for the All-In-One plan, with higher tiers unlocking fundamentals, intraday, and bulk endpoints. See eodhd.com/pricing for current rates.

### Can I limit what my agent is allowed to do with the EODHD Financial Data API?

Yes. Because you run Jentic One yourself, your own rules decide which EODHD operations and credentials the agent may use, and you grant only the ones it needs. Since EODHD is read-only reference data, you can allow just GET /eod/{ticker} for historical prices or GET /fundamentals/{ticker} for company financials while leaving everything else out of reach. The screener at GET /screener or the news feed at GET /news is callable only if you add it to that allowed set. Your api_token is stored encrypted by your own instance and injected at execution time, so the agent never sees the raw key.