[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [EODHD historical prices](https://spiral.ai/integrations/gemini-cli/eodhd-historical-prices)

# How to Use EODHD historical prices in Gemini CLI

Get historical open, high, low, close, adjusted close, and volume for one instrument. Use it to compare performance, calculate drawdowns, or study trading activity, with split- and dividend-adjusted closes for return calculations.

|  |  |
| --- | --- |
| Model | EODHD historical prices |
| Available through | Alexandria |
| Category | Finance |
| Price | Up to $0.17459 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with EODHD historical prices in Gemini CLI

- Use EODHD historical prices for AAPL.US from January 1 through December 31, 2024. Add a chart to this project showing raw close and adjusted close as separate labeled series.
- Use EODHD historical prices for MSFT.US and VTI.US from January 1, 2020, through December 31, 2024. Add a report comparing cumulative returns calculated from adjusted closes.
- Use EODHD historical prices for TSLA.US during 2024. Add a function that calculates maximum drawdown from adjusted closes and returns the peak and trough dates.
- Use EODHD historical prices for AMZN.US during 2024. Build a table in this project of sessions with volume above twice the preceding 20-session average.
- Use EODHD historical prices for EURUSD.FOREX during 2024. Add a monthly summary of opening, highest, lowest, and closing values to the project's research report.

## How to set up EODHD historical prices in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run EODHD historical prices**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "eodhd/prices/eod",
    "input": {
      "ticker": "<ticker>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds EODHD historical prices on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## EODHD historical prices tools and prices

- [EODHD · End-of-day prices](https://spiral.ai/tools/alexandria/eodhd/prices/eod) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| to |  | — | Window end, YYYY-MM-DD, inclusive. |
| from |  | — | Window start, YYYY-MM-DD, inclusive. Without from and to EODHD returns the whole history, which can be over 20,000 rows. |
| order | a, d | — | a oldest first, d newest first. Default a. |
| period | d, w, m | — | Bar size: d daily, w weekly, m monthly. Default d. |

## What can you do with EODHD historical prices in Gemini CLI?

Build a historical performance report from EODHD price bars in your project. Your coding agent can calculate returns, drawdowns, and volume comparisons from the retrieved series.

### Compare investment performance

Compare Apple, Microsoft, and a broad-market ETF over the same dates using adjusted closes. Calculate cumulative returns from the retrieved series.

### Measure historical drawdowns

Calculate the largest decline from a previous peak for a stock or ETF. Report the peak, trough, and any subsequent recovery using adjusted closes.

### Build a research backtest

Use daily adjusted closes to evaluate a moving-average rule on a named public stock. Compare the calculated result with holding that stock over the same dates.

### Study unusual trading volume

Compare each day's reported volume with its recent average. Identify unusually active sessions and show their daily price ranges.

### Review stock split effects

Place raw closes beside adjusted closes around a stock split. Show how the choice of series changes the apparent price movement.

### Summarize a reporting period

Turn a stock's historical daily bars into a monthly research summary with its opening price, highest and lowest prices, closing price, and total volume.

### Analyze currency and crypto history

Calculate historical changes and drawdowns for EUR/USD or Bitcoin against the US dollar. Keep each instrument's results separate for comparison.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## EODHD historical prices in other agents

- [Amp](https://spiral.ai/integrations/amp/eodhd-historical-prices)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/eodhd-historical-prices)
- [Claude](https://spiral.ai/integrations/claude-desktop/eodhd-historical-prices)
- [Claude Code](https://spiral.ai/integrations/claude-code/eodhd-historical-prices)
- [Cline](https://spiral.ai/integrations/cline/eodhd-historical-prices)
- [Codex](https://spiral.ai/integrations/codex/eodhd-historical-prices)
- [Cursor](https://spiral.ai/integrations/cursor/eodhd-historical-prices)
- [Devin](https://spiral.ai/integrations/devin/eodhd-historical-prices)
- [dots](https://spiral.ai/integrations/dots/eodhd-historical-prices)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/eodhd-historical-prices)
- [Gemini](https://spiral.ai/integrations/gemini/eodhd-historical-prices)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/eodhd-historical-prices)
- [goose](https://spiral.ai/integrations/goose/eodhd-historical-prices)
- [Grok](https://spiral.ai/integrations/grok/eodhd-historical-prices)
- [Grok Build](https://spiral.ai/integrations/grok-build/eodhd-historical-prices)
- [Hermes](https://spiral.ai/integrations/hermes/eodhd-historical-prices)
- [Instinct](https://spiral.ai/integrations/instinct/eodhd-historical-prices)
- [Manus](https://spiral.ai/integrations/manus/eodhd-historical-prices)
- [Muse](https://spiral.ai/integrations/muse/eodhd-historical-prices)
- [Muse Code](https://spiral.ai/integrations/muse-code/eodhd-historical-prices)
- [n8n](https://spiral.ai/integrations/n8n/eodhd-historical-prices)
- [Notion](https://spiral.ai/integrations/notion/eodhd-historical-prices)
- [OpenClaw](https://spiral.ai/integrations/openclaw/eodhd-historical-prices)
- [opencode](https://spiral.ai/integrations/opencode/eodhd-historical-prices)
- [Perplexity](https://spiral.ai/integrations/perplexity/eodhd-historical-prices)
- [Raycast](https://spiral.ai/integrations/raycast/eodhd-historical-prices)
- [VS Code](https://spiral.ai/integrations/vscode/eodhd-historical-prices)
- [Windsurf](https://spiral.ai/integrations/windsurf/eodhd-historical-prices)
- [Zapier](https://spiral.ai/integrations/zapier/eodhd-historical-prices)

## More Gemini CLI guides

- [EODHD exchange tickers](https://spiral.ai/integrations/gemini-cli/eodhd-exchange-tickers)
- [EODHD stock split history](https://spiral.ai/integrations/gemini-cli/eodhd-stock-split-history)
- [EODHD exchange list](https://spiral.ai/integrations/gemini-cli/eodhd-exchange-list)
- [EODHD ticker lookup](https://spiral.ai/integrations/gemini-cli/eodhd-ticker-lookup)
- [EODHD earnings calendar](https://spiral.ai/integrations/gemini-cli/eodhd-earnings-calendar)
- [Eurostat city purchasing power parities](https://spiral.ai/integrations/gemini-cli/eurostat-city-purchasing-power-parities)

## Questions about EODHD historical prices in Gemini CLI

**Can Gemini CLI use EODHD historical prices?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run EODHD historical prices like any built-in tool.

**How much does EODHD historical prices cost in Gemini CLI?**

Up to $0.17459 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use EODHD historical prices in Gemini CLI?**

No. Spiral runs EODHD historical prices on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up EODHD historical prices in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while EODHD historical prices runs?**

EODHD historical prices runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Which markets and assets does EODHD cover?**

EODHD advertises historical coverage across more than 60 exchanges. The endpoint supports stocks, ETFs, funds, indices, forex pairs, and digital currencies.

**When are end-of-day prices updated?**

Most exchanges update 2 to 3 hours after closing; NYSE and NASDAQ update within 15 minutes. US mutual funds, PINK, OTCBB, and some indices update the next morning, usually finishing at 5 to 6 a.m. Eastern.

**Are historical prices adjusted for splits and dividends?**

Adjusted close accounts for both splits and dividends. Open, high, low, and close remain unadjusted, while volume is adjusted for splits.

**Can I republish EODHD prices?**

EODHD's personal-use terms allow private, noncommercial analysis but prohibit redistribution and display. Business use requires commercial licensing; personal-use permission does not cover a public price dashboard.

