EODHD Claude Skills: Teach Your AI Assistant the Entire Financial API

AI coding assistants like Claude and Codex are transforming how developers work with APIs. But without structured knowledge about specific APIs, these assistants rely on general training data – which means outdated endpoints, wrong parameter names, and hallucinated responses. EODHD Claude Skills solves this by giving your AI assistant expert-level knowledge of the entire EODHD Financial API.

This article explains what Claude Skills are, why they matter for financial data workflows, and how to install and use the EODHD skills library in under 5 minutes.

What Are Claude Skills?

Claude Skills are structured knowledge packs that teach AI assistants how to use specific tools and APIs correctly. Think of them as a detailed instruction manual that Claude reads before answering your questions.

Without skills, when you ask Claude “get me AAPL historical prices from EODHD”, it has to guess the endpoint URL, parameter names, and response format. It might get it right, or it might hallucinate an endpoint that doesn’t exist.

With the EODHD skills installed, Claude knows the exact endpoint (/api/eod/AAPL.US), the correct parameters (from, to, fmt, api_token), and the precise response structure. It can also write working Python scripts, handle edge cases, and explain what each field means.

What Is EODHD Claude Skills?

EODHD Claude Skills is an open-source skill adapter library that enables AI agents (Claude, Codex) to interact with the EODHD Financial API accurately and reliably. It includes:

72 documented API endpoints – stocks, options, crypto, indices, macro, and marketplace data
28 reference guides – authentication, exchanges, rate limits, symbol format, fundamentals, and more
Lightweight Python client – zero external dependencies, works out of the box
Analysis templates – reproducible report formats for consistent output
7 subscription plan guides – so the AI knows what data your plan can access

Why You Need This

If you use Claude Code, Codex, or any AI coding assistant with EODHD data, you have likely encountered these problems:

Wrong endpoints – the AI guesses a URL that doesn’t exist or has been deprecated
Incorrect parameters – wrong date format, missing required fields, unknown query params
Outdated information – AI training data is months or years behind the current API
No marketplace knowledge – the AI has no idea about Options, Tick Data, ESG, or other marketplace products
Trial and error – you end up debugging the AI’s code instead of your own

EODHD Claude Skills eliminates all of these issues. Once installed, your AI assistant has complete, up-to-date knowledge of every EODHD endpoint, parameter, and response format.

Installation

Claude Code (Plugin System)

The fastest way to install is via the Claude Code plugin system. Open your terminal and run:

# Register the marketplace
/plugin marketplace add EodHistoricalData/eodhd-claude-skills

# Install the plugin
/plugin install eodhd-api@eodhd-claude-skills

That’s it. Set your API token and start working:

export EODHD_API_TOKEN="your_token_here"

To manage the plugin later:

/plugin update eodhd-api@eodhd-claude-skills      # Update to latest version
/plugin enable eodhd-api@eodhd-claude-skills       # Enable
/plugin disable eodhd-api@eodhd-claude-skills      # Disable
/plugin uninstall eodhd-api@eodhd-claude-skills    # Uninstall

Manual Setup

If you prefer manual installation, clone the repository:

git clone https://github.com/EodHistoricalData/eodhd-claude-skills.git
export EODHD_API_TOKEN="your_token_here"

What Is Covered

The skills library documents 72 EODHD API endpoints across all major categories:

Market Data

Endpoint	Description
Historical Stock Prices (EOD)	End-of-day OHLCV data for stocks, ETFs, funds
Intraday Historical Data	1m, 5m, 1h bars for intraday analysis
Live Price Data	Delayed real-time quotes with bid/ask
US Live Extended Quotes	Extended quote data for US markets
WebSockets Real-Time Data	Streaming live prices via WebSocket
Technical Indicators	SMA, EMA, RSI, MACD, Bollinger Bands, and more
Stock Screener	Filter stocks by fundamentals, price, volume
Historical Market Cap	Historical market capitalization data

Fundamentals & Company Data

Endpoint	Description
Fundamentals Data	Balance sheet, income, cash flow for stocks, ETFs, funds
Bulk Fundamentals	Fundamentals for all tickers on an exchange in one call
Company News	News articles with sentiment scores
Sentiment Data	Aggregated news sentiment by ticker
Insider Transactions	SEC insider buy/sell activity

Calendar & Events

Endpoint	Description
Upcoming Earnings	Earnings calendar with estimates
Upcoming Dividends	Dividend calendar with ex-dates and amounts
Upcoming Splits	Stock split calendar
Upcoming IPOs	IPO calendar with pricing details
Economic Events	Macro event calendar (FOMC, CPI, NFP, etc.)

Marketplace Products

The skills also cover EODHD Marketplace products, including US Options (EOD + contracts), Tick Data, TradingHours, Illio Analytics, Investverte ESG, and PRAAMS risk analytics.

Reference Guides

Beyond endpoints, the library includes 28 reference guides that help Claude understand the EODHD ecosystem:

Authentication – API tokens, security, CORS, environment setup
Symbol Format – ticker format rules (AAPL.US, BTC-USD.CC, EURUSD.FOREX)
Exchanges – 70+ supported exchanges with trading hours and coverage
Rate Limits – API quotas, optimization strategies
Fundamentals – deep guides for stocks, ETFs, funds, crypto
Data Adjustments – split and dividend adjustment methodology
Pricing and Plans – what data each subscription tier can access

Usage Examples

Once the skill is installed, you can interact with EODHD data through natural language prompts. Here are practical examples across different use cases.

Fetch Historical Prices

Use the eodhd-api plugin. Fetch daily OHLCV for AAPL.US from 2024-01-01 to 2024-12-31
and show the first and last 5 rows. API key: demo.

Claude will call the correct endpoint (/api/eod/AAPL.US), use the right parameters, and format the output in a readable table.

Fundamental Analysis

Use the eodhd-api plugin. Give me a full fundamental analysis of NVDA.US: revenue and
earnings growth (last 4 quarters and 3 years), operating margin trend, P/E and EV/EBITDA
vs sector peers, insider activity over the past 6 months, and latest news sentiment.
API key: EODHD_API_TOKEN.

Compare Multiple Stocks

Use the eodhd-api plugin. Compare AAPL.US, MSFT.US, GOOGL.US, and AMZN.US across:
P/E ratio, EV/EBITDA, revenue growth (YoY), operating margin, and net debt/EBITDA.
Present as a table and identify the most attractively valued. API key: EODHD_API_TOKEN.

Write Python Scripts

Use the eodhd-api plugin. Write a Python script that fetches EOD prices for all S&P 500
constituents and computes the total price return for each ticker over a given date range.
Accept --from-date, --to-date, and --api-key as arguments. Use only stdlib, no pandas.

Because Claude has the skill loaded, it will use the correct EODHD endpoints, handle pagination for bulk data, and respect rate limits — all without you having to specify any of that.

Macro & Treasury Analysis

Use the eodhd-api plugin. Pull US CPI inflation and the 10-year Treasury par yield from
2010 to 2024. Overlay SPY.US calendar-year returns and describe the historical relationship
between inflation regimes, rate levels, and equity performance. API key: EODHD_API_TOKEN.

Options Chain Analysis

Use the eodhd-api plugin. Pull the current options chain for AAPL.US expiring in
the next 30 days. Show the five strikes nearest the money on each side with their IV,
delta, and open interest. API key: EODHD_API_TOKEN.

Built-in Python Client

The skills library ships with a lightweight Python client that requires zero external dependencies. It works with Python 3.8+ and supports the most common EODHD endpoints out of the box.

# Historical prices
python skills/eodhd-api/scripts/eodhd_client.py \
  --endpoint eod --symbol AAPL.US \
  --from-date 2025-01-01 --to-date 2025-03-31

# Company fundamentals
python skills/eodhd-api/scripts/eodhd_client.py \
  --endpoint fundamentals --symbol NVDA.US

# Intraday 5-minute bars
python skills/eodhd-api/scripts/eodhd_client.py \
  --endpoint intraday --symbol TSLA.US \
  --interval 5m --from-date 2025-01-15

# Technical indicator (50-day SMA)
python skills/eodhd-api/scripts/eodhd_client.py \
  --endpoint technical --symbol AAPL.US --function sma --period 50

# Stock screener
python skills/eodhd-api/scripts/eodhd_client.py \
  --endpoint screener --limit 20

# Account status and API usage
python skills/eodhd-api/scripts/eodhd_client.py --endpoint user

Tips for Best Results

Claude Code treats installed skills as optional context. To make sure the skill is always used when you work with financial data, follow these tips:

Reference the Skill in Your Prompt

Start your message with a line like:

Use the eodhd-api plugin. Get me AAPL.US daily prices for the last 30 days.

Add a Project-Level Instruction

Create or edit a CLAUDE.md in your project root and add:

Always use available skills (especially eodhd-api) when handling financial data requests.

Claude Code reads CLAUDE.md at the start of every session, so this acts as a persistent hint.

Add a Global Instruction

To apply the hint across all your projects, add the following to your ~/.claude/CLAUDE.md:

Use available skills whenever they match the task at hand.

Repository Structure

eodhd-claude-skills/
├── skills/
│   └── eodhd-api/
│       ├── SKILL.md              # Primary skill definition
│       ├── references/
│       │   ├── general/          # 28 reference guides
│       │   ├── endpoints/        # 72 endpoint docs
│       │   ├── subscriptions/    # 7 plan guides
│       │   └── workflows.md      # Analysis patterns
│       ├── scripts/
│       │   └── eodhd_client.py   # Python client (stdlib-only)
│       └── templates/
│           └── analysis_report.md
├── adapters/
│   ├── claude/                   # Claude environment adapter
│   └── codex/                    # Codex environment adapter
├── CLAUDE.md                     # Project context
└── README.md

Who Is This For

Developers building apps with EODHD data – stop guessing endpoints, let the AI do it right
Quants and analysts – ask for complex analyses in plain language, get reproducible Python scripts
Data engineers – automate data pipeline generation with correct API calls from day one
Anyone using Claude Code with financial data – one install, permanent upgrade to AI accuracy

Getting Started

Get your EODHD API token at eodhd.com
Install the skills: github.com/EodHistoricalData/eodhd-claude-skills
Explore EODHD API documentation at eodhd.com/financial-apis
Questions? Contact supportlevel1@eodhistoricaldata.com