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

# How to Use Tiingo ticker search in Instinct

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 Instinct

- Every Monday, use Tiingo ticker search for AAPL, MSFT, and NVDA and report any changes in their returned names or activity status.
- Each week, use Tiingo ticker search for SPY, VTI, and VFINX and report changes in the returned asset types or active status.
- Every Friday, use Tiingo ticker search for BRK-A and BRK-B and flag any change in their returned symbols or names.
- Once a month, use Tiingo ticker search for Lehman Brothers, including delisted assets, and report changes in the returned matches.
- Each Monday, use Tiingo ticker search for NVIDIA and report whether the returned names and symbols differ from the previous check.

## How to set up Tiingo ticker search in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

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

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

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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: Instinct finds Tiingo ticker search on Spiral, shows the price and runs it.

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

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

Flag changes in how Tiingo identifies a fixed list of public securities. A scheduled agent can repeat searches and report changes in returned names, asset types, and active status.

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

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

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

## Questions about Tiingo ticker search in Instinct

**Can Instinct use Tiingo ticker search?**

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

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

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

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

You need no Alexandria account. Instinct 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 Instinct?**

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

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

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

