[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Tiingo ticker search](https://spiral.ai/integrations/claude-code/tiingo-ticker-search)

# How to Use Tiingo ticker search in Claude Code

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 Claude Code

- 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 Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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: Claude Code finds Tiingo ticker search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## 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 Claude Code?

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 Claude Code guides](https://spiral.ai/integrations/claude-code)

## 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)
- [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)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/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 Claude Code guides

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

## Questions about Tiingo ticker search in Claude Code

**Can Claude Code use Tiingo ticker search?**

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

**How much does Tiingo ticker search cost in Claude Code?**

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 Claude Code plan is separate.

**Do I need an Alexandria account to use Tiingo ticker search in Claude Code?**

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 Claude Code?**

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

**Does Claude Code wait while Tiingo ticker search runs?**

Tiingo ticker search runs in the background. Claude Code 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.

