← Back to Skills Marketplace
mancubus77

eodhd.com | Financial data from around the world

by mancubus77 · GitHub ↗ · v0.0.1 · MIT-0
cross-platform ✓ Security Clean
112
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install eodhd-curl
Description
Provides access to EODHD financial data APIs covering company information, market prices, fundamentals, economic data, exchange info, and alternative dataset...
README (SKILL.md)

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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: eodhd-com Version: 0.0.1 The skill provides a comprehensive set of instructions and curl examples for interacting with the EODHD financial data API. It correctly identifies the need for an API token (EODHD_API_TOKEN), explicitly warns against hardcoding it, and uses the legitimate service endpoint (eodhd.com) for all requests without any signs of data exfiltration or malicious execution.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install eodhd-curl
  3. After installation, invoke the skill by name or use /eodhd-curl
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.1
Version 1.0.0 — Major skill definition rewrite with implementation and reference files removed. - Removed all implementation, script, and reference files including CLI entrypoint, CI checks, and guidance docs. - Replaced the skill definition with an expanded manifest and a comprehensive usage and routing guide for the EODHD API. - Updated authentication to require only the environment variable EODHD_API_TOKEN. - Provided detailed curl usage patterns and parameter tables for all major EODHD endpoints. - Summary and examples now focus on API usage, not local CLI packaging or OpenClaw deployment rules.
Metadata
Slug eodhd-curl
Version 0.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 112 downloads so far.

How do I install eodhd.com | Financial data from around the world?

Run "/install eodhd-curl" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is eodhd.com | Financial data from around the world free?

Yes, eodhd.com | Financial data from around the world is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does eodhd.com | Financial data from around the world support?

eodhd.com | Financial data from around the world is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created eodhd.com | Financial data from around the world?

It is built and maintained by mancubus77 (@mancubus77); the current version is v0.0.1.

💬 Comments