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

# How to Use EODHD IPO calendar in Gemini CLI

Get IPO filing and trading dates, listing exchanges, offering ranges, share counts, and deal status. Use it to follow companies going public and distinguish expected listings from priced deals.

|  |  |
| --- | --- |
| Model | EODHD IPO calendar |
| 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 IPO calendar in Gemini CLI

- Use EODHD IPO calendar for January 2025 and build a view in this project that separates Expected, Priced, Filed, and Amended deals.
- Use EODHD IPO calendar for March 2025 and add a sortable table to this project with company name, exchange, expected trading date, shares offered, and deal status.
- Use EODHD IPO calendar to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from EODHD IPO calendar and tell me what changed since last week.
- Check EODHD IPO calendar and summarize what you find in three bullet points.

## How to set up EODHD IPO calendar 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 IPO calendar**: 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/calendar/ipos",
    "input": {
      "to": "<to>"
    }
  }'
```

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

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

## EODHD IPO calendar tools and prices

- [EODHD · IPO calendar](https://spiral.ai/tools/alexandria/eodhd/calendar/ipos) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| to |  | — | First-trading-date window end, YYYY-MM-DD. Default from plus 7 days. At most 366 days after from, and to needs from. |
| from |  | — | First-trading-date window start, YYYY-MM-DD. Default today. |

## What can you do with EODHD IPO calendar in Gemini CLI?

Build a corporate events view that shows earnings expectations and IPO deal status beside each date. A coding agent can turn EODHD responses into tables in your project, preserving fiscal periods, listing exchanges, and offering details.

### Prepare a weekly market agenda

Arrange earnings announcements and expected IPO trading dates into a dated research agenda, with earnings-session timing and IPO deal status beside each event.

### Build a corporate events dashboard

Display company earnings with actual and estimated EPS, alongside IPO listings with exchange, shares offered, and deal status.

### Review changes between calendar checks

Compare successive responses to flag changed earnings dates or figures and changed IPO dates, offering details, or status for analyst review.

### Create a monthly company events recap

Summarize earnings surprises and IPO deals marked Priced during the selected month, keeping reported results separate from expected events.

### Compare IPO offering structures

Review IPOs by listing exchange, offering currency, share count, and deal status to prepare a new-listings research shortlist.

## Overview

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

## EODHD IPO calendar in other agents

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

## More Gemini CLI guides

- [EIA energy observations](https://spiral.ai/integrations/gemini-cli/eia-energy-observations)
- [EODHD company fundamentals](https://spiral.ai/integrations/gemini-cli/eodhd-company-fundamentals)
- [EIA dataset filter codes](https://spiral.ai/integrations/gemini-cli/eia-dataset-filter-codes)
- [EODHD dividend history](https://spiral.ai/integrations/gemini-cli/eodhd-dividend-history)
- [EIA dataset directory](https://spiral.ai/integrations/gemini-cli/eia-dataset-directory)
- [EODHD earnings calendar](https://spiral.ai/integrations/gemini-cli/eodhd-earnings-calendar)

## Questions about EODHD IPO calendar in Gemini CLI

**Can Gemini CLI use EODHD IPO calendar?**

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

**How much does EODHD IPO calendar 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 IPO calendar in Gemini CLI?**

No. Spiral runs EODHD IPO calendar 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 IPO calendar in Gemini CLI?**

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

**Does Gemini CLI wait while EODHD IPO calendar runs?**

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

**What company events does EODHD return?**

Earnings records pair report dates with actual EPS, consensus estimates, and surprise figures. IPO records describe companies going public, including their exchange, offering details, and filing or deal status.

**Do all the dates mean the same thing?**

EODHD distinguishes an earnings announcement date from the fiscal period end the results describe. IPO records separately identify expected trading, initial filing, and amendment dates.

**How should I handle larger historical requests?**

Earnings results are not paginated, so EODHD recommends short date windows. Its August 2026 assessment found continuous IPO history from February 2013, plus an isolated batch of 84 deals in early 2010.

**Where does EODHD collect company information?**

EODHD describes its fundamental-data sources as company announcements, financial news providers, investor relations websites, and annual reports. This is its general sourcing description, rather than an attribution for each calendar record.

**Does EODHD guarantee real-time, accurate event data?**

EODHD's terms explicitly say API data is not necessarily real-time or accurate. Its calendars should therefore not be presented as a guaranteed live record of company announcements.

