[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Tiingo ticker search](https://spiral.ai/integrations/gemini-cli/tiingo-ticker-search)

# How to Use Tiingo ticker search in Gemini CLI

Find assets in Tiingo's database by ticker or name, with results identifying the asset name, type, and active or delisted status. Use it to resolve a company or fund name before requesting market data.

|  |  |
| --- | --- |
| Model | Tiingo ticker search |
| 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 Tiingo ticker search in Gemini CLI

- Use Tiingo ticker search to look up Microsoft and compare the returned ticker and name with Microsoft's entry in my project's watchlist.
- Use Tiingo ticker search for AAPL, MSFT, and NVDA, then show the returned names, asset types, and active status in a terminal table.
- Use Tiingo ticker search for Vanguard and build a local research view that separates returned candidates by asset type.
- Use Tiingo ticker search for BRK-A and BRK-B, then check whether my project's symbol normalization preserves the returned share-class symbols.
- Use Tiingo ticker search for Lehman Brothers, including delisted assets, and show the returned names, symbols, and active status.

## How to set up Tiingo ticker search 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 Tiingo ticker search**: 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": "tiingo/symbols/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Tiingo ticker search on Spiral, shows the price and runs it.

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

## Tiingo ticker search tools and prices

- [Tiingo · Symbol search](https://spiral.ai/tools/alexandria/tiingo/symbols/search) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | — | Matches to return, from 1 to 100. Default 10. |
| includeDelisted |  | — | When true, include delisted tickers. Default false. |
| exactTickerMatch |  | — | When true, only exact ticker matches. Names are not searched. Default false. |

## What can you do with Tiingo ticker search in Gemini CLI?

Resolve company and fund names into Tiingo symbols for a research prototype. A coding agent can compare returned names, types, and activity status with entries in your project's watchlist.

### Resolve company names before market research

Search for Microsoft or NVIDIA and compare the returned names and tickers before choosing an asset for further research.

### Check symbols in an imported watchlist

Look up AAPL, MSFT, and NVDA to review the corresponding asset names, types, and active status before using an imported list.

### Separate fund and stock matches

Search for Vanguard and organize the returned candidates by asset type to narrow a fund research list.

### Resolve share classes

Look up BRK-A and BRK-B separately and compare their returned names before selecting a Berkshire Hathaway security.

### Review delisted asset references

Search for Lehman Brothers, including delisted results, to inspect the symbols and activity status Tiingo returns for historical research.

### Monitor a fixed research list

Repeat searches for selected company or fund names and flag changes in returned names, asset types, or active status for review.

## Overview

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

## Tiingo ticker search in other agents

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

## More Gemini CLI guides

- [Tiingo ticker metadata](https://spiral.ai/integrations/gemini-cli/tiingo-ticker-metadata)
- [Treasury Fiscal Data dataset search](https://spiral.ai/integrations/gemini-cli/treasury-fiscal-data-dataset-search)
- [Tiingo historical stock prices](https://spiral.ai/integrations/gemini-cli/tiingo-historical-stock-prices)
- [Treasury Fiscal Data latest figures](https://spiral.ai/integrations/gemini-cli/treasury-fiscal-data-latest-figures)
- [Tiingo financial news](https://spiral.ai/integrations/gemini-cli/tiingo-financial-news)
- [Treasury Fiscal Data published reports](https://spiral.ai/integrations/gemini-cli/treasury-fiscal-data-published-reports)

## Questions about Tiingo ticker search in Gemini CLI

**Can Gemini CLI use Tiingo ticker search?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Tiingo ticker search like any built-in tool.

**How much does Tiingo ticker search 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 Tiingo ticker search in Gemini CLI?**

No. Spiral runs Tiingo ticker search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Tiingo ticker search in Gemini CLI?**

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

**Does Gemini CLI wait while Tiingo ticker search runs?**

Tiingo ticker search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**What kinds of assets does Tiingo search return?**

The documented asset types are stocks, ETFs, and mutual funds. Results identify the ticker, asset name, asset type, and whether the ticker is actively quoted.

**How does Tiingo match a search?**

Tiingo searches for ticker matches first, then expands to matches in the asset name. Compare the returned names and asset types when a search produces several candidates.

**Is the search response stable?**

Tiingo currently labels search early beta and says response objects can change. Its documentation recommends against building production code with the endpoint while it remains in beta.

**How frequently does Tiingo refresh its ticker directory?**

Tiingo says its downloadable supported-ticker list is updated daily. That schedule describes the directory download, rather than a guaranteed refresh schedule for search results.

**Can I publish Tiingo search results?**

Tiingo's terms restrict API data to internal consumption. Redistribution requires Tiingo's permission, including when the underlying companies and funds are public.

