eodhd-claude-skills

EODHD Skills Adapter for Claude/Codex

Reusable skills and adapters for using the EOD Historical Data (EODHD) API from Claude- and Codex-style agent workflows.

Disclaimer: This skill set may differ from actual EODHD API endpoints and behavior, both due to possible errors and contradictions in the documentation and because the API is constantly changing and evolving. Furthermore, Claude and the Codex may interpret the information provided incorrectly. Some data, such as update times, is empirical in nature and is provided for guidance only. For any questions, please email supportlevel1@eodhistoricaldata.com

Table of Contents

• Installation
• Overview
• Prerequisites
• Repository Structure
• Quick Start
• Usage Tips
• Supported Endpoints
• General Reference Documentation
• Usage Examples
• Workflows
• Contributing
• License

Installation

Claude Code (Plugin System)

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

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

Manage the plugin:

/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

Clone the repository and set your API token:

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

Overview

This repository provides a skill adapter that enables AI agents (Claude, Codex, etc.) to interact with the EODHD financial data API. It includes:

• Skill definitions with trigger conditions, workflows, and output standards
• Endpoint documentation for 72 EODHD API endpoints
• General reference guides covering 28 topics (exchanges, symbol format, rate limits, fundamentals, etc.)
• A lightweight Python client (stdlib-only, no external dependencies)
• Analysis templates for consistent, auditable output
• Adapter guides for different AI environments

Prerequisites

1. EODHD API Token: Get one at eodhd.com
2. Python 3.8+ (for the helper client)
3. No external Python packages required (stdlib-only)

Repository Structure

eodhd-claude-skills/
├── .claude-plugin/
│   └── marketplace.json          # Plugin manifest for Claude Code
├── .github/
│   └── workflows/
│       └── release.yml           # Auto-release on version bump
├── skills/
│   └── eodhd-api/
│       ├── SKILL.md              # Primary skill definition
│       ├── references/
│       │   ├── general/          # General reference guides (28 files)
│       │   ├── endpoints/        # Individual endpoint docs (72 files)
│       │   ├── subscriptions/    # Subscription plan guides (7 plans)
│       │   └── workflows.md      # Common analysis patterns
│       ├── scripts/
│       │   └── eodhd_client.py   # Lightweight Python API client
│       └── templates/
│           └── analysis_report.md
├── adapters/
│   ├── claude/
│   │   └── eodhd-api.md          # Claude environment adapter
│   └── codex/
│       └── eodhd-api.md          # Codex environment adapter
├── CLAUDE.md                     # Claude Code project context
└── README.md

Quick Start

1. Set your API token

export EODHD_API_TOKEN="your_token_here"

If you installed via the plugin system, the skill is already available in Claude Code. Just set the token and start asking for financial data.

2. Use the helper client

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

# Get company fundamentals
python skills/eodhd-api/scripts/eodhd_client.py \
  --endpoint fundamentals \
  --symbol MSFT.US

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

# List exchange symbols
python skills/eodhd-api/scripts/eodhd_client.py \
  --endpoint exchange-symbol-list \
  --symbol US

3. Use in agent prompts

Use the `eodhd-api` plugin. Pull daily prices for AAPL.US from 2025-01-01 to 2025-01-31,                                                           
include fundamentals summary, and return a concise analyst report with reproducible calls. Use "demo" API key.

Usage Tips

After installing the skill plugin, Claude Code won't always use it automatically — you may need to nudge it. Here are a few ways to make sure the skill gets picked up:

Prompt prefix

Start your message with a line like: