eodhd-client

Small Python SDK for the EODHD market data APIs.

The package is built for reuse across projects:

• synchronous requests-based client
• no pandas dependency in the core install
• optional dataframe helpers in eodhd_client.pandas
• thin CLI for quick pulls and shell workflows

Install

pip install -e /Users/ryan/code/eodhd-client

With dataframe helpers:

pip install -e /Users/ryan/code/eodhd-client[pandas]

Quick Start

from eodhd_client import EODHDClient

client = EODHDClient(api_key="YOUR_API_KEY")

prices = client.get_eod("AAPL.US", from_date="2025-01-01", to_date="2025-01-31")
search_results = client.search("tesla", limit=5)
option_rows = client.get_option_eod(
    underlying_symbol="AAPL",
    option_type="call",
    exp_date_eq="2025-12-19",
    strike_from=200,
    strike_to=200,
)

CLI

export EODHD_API_KEY=YOUR_API_KEY

eodhd-client eod AAPL.US --from-date 2025-01-01 --to-date 2025-01-31 --pretty
eodhd-client search tesla --limit 5 --pretty
eodhd-client exchanges --pretty
eodhd-client options-underlyings --pretty
eodhd-client options-eod --underlying-symbol AAPL --option-type call --exp-date-eq 2025-12-19 --pretty

Public API

• EODHDClient.get_eod()
• EODHDClient.search()
• EODHDClient.list_exchanges()
• EODHDClient.list_exchange_symbols()
• EODHDClient.get_exchange_details()
• EODHDClient.get_symbol_change_history()
• EODHDClient.list_option_underlyings()
• EODHDClient.list_option_contracts()
• EODHDClient.get_option_eod()

Official Docs

• https://eodhd.com/financial-apis/api-for-historical-data-and-volumes
• https://eodhd.com/financial-apis/search-api-for-stocks-etfs-mutual-funds
• https://eodhd.com/financial-apis/exchanges-api-trading-hours-and-stock-market-holidays
• https://eodhd.com/marketplace/unicornbay/options