eodhd.com | Financial data from around the world

Provides access to EODHD financial data APIs covering company information, market prices, fundamentals, economic data, exchange info, and alternative dataset...

Security Scan

This instruction-only skill is internally consistent: it uses curl to call eodhd.com REST endpoints and only requires a single API token (EODHD_API_TOKEN), which matches the stated purpose.

Purpose & Capability

Name/description claim access to EODHD financial APIs and the skill only requires curl and an EODHD API token — both are directly relevant and expected.

Instruction Scope

SKILL.md only instructs the agent to call eodhd.com endpoints via curl and to read EODHD_API_TOKEN from the environment; it does not ask for unrelated files, system config, or other credentials.

Install Mechanism

No install spec and no code files — lowest-risk instruction-only skill. It relies on curl being present (declared) and does not download or write code to disk.

Credentials

Only one required env var (EODHD_API_TOKEN) is declared and used; that is proportionate for an API-based financial data skill.

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges or modify other skills; normal autonomous invocation is allowed by default.

Assessment

This skill appears to do what it says. Before installing, confirm you trust the eodhd.com provider and use a least-privilege API key (read-only if available). Set EODHD_API_TOKEN as an environment variable (do not paste the key into chat). Monitor usage and rotate the key if you suspect misuse. Because the skill reads the token from your environment, ensure agents running with this skill only have access to the intended environment variables.

EODHD Financial APIs

Routing for company information

When the user asks for company information, company profile, tell me about a company, what company is this ticker, or similar, use these endpoints in this order:

1. Fundamentals API — primary source for full company profile and fundamentals
2. Search API — find the correct symbol when the user gives only a name
3. Exchange Symbol List API — validate symbol, company name, exchange, type, ISIN
4. ID Mapping API — resolve ISIN / CUSIP / FIGI / LEI / CIK to ticker
5. News API — add recent company-specific news when requested
6. Insider Transactions API — add insider activity when requested
7. Calendar API — add earnings, dividends, IPO, or split events when requested

Minimum company-info response

For a company-info request, try to return:

• Company name
• Ticker and exchange
• Sector and industry
• Business description
• Website
• Country / address when available
• Market cap / valuation highlights when available
• Recent earnings / dividend / insider context when the user asks for it

Primary company-profile curl examples

# Full company profile + fundamentals
curl "https://eodhd.com/api/fundamentals/AAPL.US?api_token=${EODHD_API_TOKEN}"

# Only general company profile fields
curl "https://eodhd.com/api/fundamentals/AAPL.US?api_token=${EODHD_API_TOKEN}&filter=General"

# Company highlights / valuation
curl "https://eodhd.com/api/fundamentals/AAPL.US?api_token=${EODHD_API_TOKEN}&filter=Highlights,Valuation"

# Find company by name first
curl "https://eodhd.com/api/search/apple?api_token=${EODHD_API_TOKEN}&limit=10&fmt=json"

# Validate company on exchange and get company name / ISIN
curl "https://eodhd.com/api/exchange-symbol-list/US?api_token=${EODHD_API_TOKEN}&fmt=json"

# Resolve ISIN to ticker
curl "https://eodhd.com/api/isin?api_token=${EODHD_API_TOKEN}&isin=US0378331005&fmt=json"

Authentication

• Base URL: https://eodhd.com/api/
• API key: ALWAYS read from env first: echo $EODHD_API_TOKEN. NEVER hardcode or guess the token. NEVER use the demo key.
• Always append &fmt=json for JSON output

Ticker Format

Asset Class	Format	Example
AU Stocks	TICKER.AU	CBA.AU
US Stocks	TICKER.US	AAPL.US
UK Stocks	TICKER.LSE	BARC.LSE
ETFs	TICKER.US	VTI.US
Crypto	SYMBOL-USD.CC	BTC-USD.CC
Forex	PAIR.FOREX	AUDUSD.FOREX
Indices	SYMBOL.INDX	GSPC.INDX

Common Parameters

Parameter	Values	Description
api_token	string	Required — your API key
fmt	json / csv	Response format (default: csv)
from	YYYY-MM-DD	Start date
to	YYYY-MM-DD	End date
order	a / d	Ascending or descending
period	d / w / m	Daily, weekly, or monthly
limit	integer	Max results
offset	integer	Pagination offset

---

1. Market Data

End-of-Day Historical Prices

curl "https://eodhd.com/api/eod/{TICKER}.{EXCHANGE}?api_token=${EODHD_API_TOKEN}&fmt=json"
curl "https://eodhd.com/api/eod/CBA.AU?api_token=${EODHD_API_TOKEN}&from=2024-01-01&to=2024-12-31&order=d&fmt=json"
curl "https://eodhd.com/api/eod/CBA.AU?api_token=${EODHD_API_TOKEN}&period=m&fmt=json"

Live / Real-Time Quotes

curl "https://eodhd.com/api/real-time/CBA.AU?api_token=${EODHD_API_TOKEN}&fmt=json"
curl "https://eodhd.com/api/real-time/CBA.AU?s=BHP.AU,ANZ.AU&api_token=${EODHD_API_TOKEN}&fmt=json"

Intraday Data

Intervals: 1m, 5m, 1h. Date range uses Unix timestamps.

curl "https://eodhd.com/api/intraday/CBA.AU?api_token=${EODHD_API_TOKEN}&interval=1h&fmt=json"
curl "https://eodhd.com/api/intraday/CBA.AU?api_token=${EODHD_API_TOKEN}&interval=5m&from=1609459200&to=1609545600&fmt=json"

Tick Data (US Only)

curl "https://eodhd.com/api/ticks/AAPL.US?api_token=${EODHD_API_TOKEN}&fmt=json&from=2024-01-02&to=2024-01-02"

Technical Indicators

Functions: sma, ema, wma, macd, rsi, atr, bbands, sar, stddev

curl "https://eodhd.com/api/technical/CBA.AU?api_token=${EODHD_API_TOKEN}&fmt=json&function=sma&period=50"
curl "https://eodhd.com/api/technical/CBA.AU?api_token=${EODHD_API_TOKEN}&fmt=json&function=rsi&period=14"

Bulk EOD (US Exchanges)

curl "https://eodhd.com/api/eod-bulk-last-day/US?api_token=${EODHD_API_TOKEN}&fmt=json"
curl "https://eodhd.com/api/eod-bulk-last-day/US?api_token=${EODHD_API_TOKEN}&symbols=AAPL,MSFT&fmt=json"

---

2. Corporate Actions

Dividends

curl "https://eodhd.com/api/div/CBA.AU?api_token=${EODHD_API_TOKEN}&fmt=json"
curl "https://eodhd.com/api/div/CBA.AU?api_token=${EODHD_API_TOKEN}&from=2020-01-01&fmt=json"

Splits

curl "https://eodhd.com/api/splits/CBA.AU?api_token=${EODHD_API_TOKEN}&fmt=json"

Stock Market Screener

curl "https://eodhd.com/api/screener?api_token=${EODHD_API_TOKEN}&filters=[[\"market_capitalization_mln\",\">\",1000]]&sort=market_capitalization_mln.desc&limit=10&fmt=json"

---

3. Fundamentals

Company Fundamentals

Full: financials, balance sheet, cash flow, holders, valuation.

curl "https://eodhd.com/api/fundamentals/CBA.AU?api_token=${EODHD_API_TOKEN}"
curl "https://eodhd.com/api/fundamentals/CBA.AU?api_token=${EODHD_API_TOKEN}&filter=General,Highlights,Valuation,Financials::Income_Statement"

ESG Scores

curl "https://eodhd.com/api/fundamentals/CBA.AU?api_token=${EODHD_API_TOKEN}&filter=ESGScores"

Historical Market Capitalisation

curl "https://eodhd.com/api/historical-market-cap/CBA.AU?api_token=${EODHD_API_TOKEN}&fmt=json&from=2020-01-01"

Insider Transactions

curl "https://eodhd.com/api/insider-transactions?api_token=${EODHD_API_TOKEN}&code=CBA.AU&fmt=json"
curl "https://eodhd.com/api/insider-transactions?api_token=${EODHD_API_TOKEN}&code=CBA.AU&from=2024-01-01&to=2024-12-31&fmt=json"

---

4. Calendar & Events

Earnings

curl "https://eodhd.com/api/calendar/earnings?api_token=${EODHD_API_TOKEN}&fmt=json&from=2025-01-01&to=2025-01-31"
curl "https://eodhd.com/api/calendar/trends?api_token=${EODHD_API_TOKEN}&symbols=CBA.AU&fmt=json"

Dividends Calendar

curl "https://eodhd.com/api/calendar/dividends?api_token=${EODHD_API_TOKEN}&fmt=json&from=2025-01-01&to=2025-01-31"

IPOs

curl "https://eodhd.com/api/calendar/ipos?api_token=${EODHD_API_TOKEN}&fmt=json&from=2025-01-01&to=2025-06-30"

Economic Events

curl "https://eodhd.com/api/economic-events?api_token=${EODHD_API_TOKEN}&fmt=json&from=2025-01-01&to=2025-01-31"
curl "https://eodhd.com/api/economic-events?api_token=${EODHD_API_TOKEN}&fmt=json&country=AU&from=2025-01-01"

---

5. News & Sentiment

curl "https://eodhd.com/api/news?api_token=${EODHD_API_TOKEN}&s=CBA.AU&limit=20&fmt=json"
curl "https://eodhd.com/api/news?api_token=${EODHD_API_TOKEN}&t=stocks&limit=20&fmt=json"
curl "https://eodhd.com/api/news?api_token=${EODHD_API_TOKEN}&s=CBA.AU&from=2024-01-01&to=2024-01-31&fmt=json"

---

6. Macro & Economic Indicators

Country codes: AUS (Australia), USA, GBR, etc.

curl "https://eodhd.com/api/macro-indicator/AUS?api_token=${EODHD_API_TOKEN}&fmt=json&indicator=gdp_current_usd"
curl "https://eodhd.com/api/macro-indicator/AUS?api_token=${EODHD_API_TOKEN}&fmt=json&indicator=inflation_consumer_prices_annual"
curl "https://eodhd.com/api/macro-indicator/AUS?api_token=${EODHD_API_TOKEN}&fmt=json"

---

7. Options (US Only)

curl "https://eodhd.com/api/options/AAPL.US?api_token=${EODHD_API_TOKEN}&fmt=json"
curl "https://eodhd.com/api/options/AAPL.US?api_token=${EODHD_API_TOKEN}&fmt=json&to=2025-03-21"

---

8. Exchange & Search

Search Tickers

curl "https://eodhd.com/api/search/commonwealth?api_token=${EODHD_API_TOKEN}&limit=10&fmt=json"
curl "https://eodhd.com/api/search/commonwealth?api_token=${EODHD_API_TOKEN}&type=stock&fmt=json"

List Tickers on Exchange

curl "https://eodhd.com/api/exchange-symbol-list/AU?api_token=${EODHD_API_TOKEN}&fmt=json"
curl "https://eodhd.com/api/exchange-symbol-list/AU?api_token=${EODHD_API_TOKEN}&fmt=json&type=etf"

List Exchanges

curl "https://eodhd.com/api/exchanges-list?api_token=${EODHD_API_TOKEN}&fmt=json"

Exchange Details (Trading Hours, Holidays)

curl "https://eodhd.com/api/exchange/AU?api_token=${EODHD_API_TOKEN}&fmt=json"

ID Mapping (ISIN / CIK to Ticker)

curl "https://eodhd.com/api/isin?api_token=${EODHD_API_TOKEN}&isin=AU000000CBA7&fmt=json"

---

9. API Usage

curl "https://eodhd.com/api/user?api_token=${EODHD_API_TOKEN}&fmt=json"

---

Notes

• Always append &fmt=json — default response is CSV
• Real-time quotes have 15-20 min delay on free plans
• Always include from and to date parameters to avoid pulling excessive data
• Rate limits depend on subscription tier — check the usage endpoint