[Integrations](https://spiral.ai/integrations) › [Muse](https://spiral.ai/integrations/muse) › [Tiingo ticker search](https://spiral.ai/integrations/muse/tiingo-ticker-search)

# How to Use Tiingo ticker search in Muse

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, with a Spiral API key |

## Prompts to try with Tiingo ticker search in Muse

- Use Tiingo ticker search to find Microsoft and show the returned ticker, name, asset type, and whether it is actively quoted.
- Use Tiingo ticker search for Vanguard and separate the returned stock, ETF, and mutual fund matches.
- Use Tiingo ticker search to look up BRK-A and BRK-B and compare their returned names and activity status.
- Use Tiingo ticker search for Lehman Brothers, including delisted assets, and explain the activity status of each result.
- Use Tiingo ticker search to look up SPY and VFINX and compare the asset types Tiingo returns.

## How to set up Tiingo ticker search in Muse

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

### Use the Muse connector

1. **Create an API key**: Create one under API keys in the Spiral console.

2. **Send Muse this message**: Muse reads Spiral's skill and asks for an API key.

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

3. **Give Muse the key**: Paste the key when Muse asks for it, never in the chat itself.

### Use the Spiral skill

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse

## 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 Muse?

Turn a company or fund name into a shortlist of Tiingo symbols to investigate. A chat app can explain the returned asset types and activity status before you choose a security.

### 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 Muse guides](https://spiral.ai/integrations/muse)

## 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)
- [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 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 Muse guides

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

## Questions about Tiingo ticker search in Muse

**Can Muse use Tiingo ticker search?**

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

**How much does Tiingo ticker search cost in Muse?**

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

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

You need no Alexandria account. Muse uses one Spiral API key for every tool, and Spiral runs Tiingo ticker search on its own Alexandria account.

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

About two minutes: create an API key, then send Muse this message, then give Muse the key.

**Does Muse wait while Tiingo ticker search runs?**

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

