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

# How to Use Tiingo ticker metadata in Instinct

Get an asset's full name, description, listing exchange, and the first and last dates of available Tiingo price history. Use it to identify a security and check whether its recorded history covers your research period.

|  |  |
| --- | --- |
| Model | Tiingo ticker metadata |
| 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 metadata in Instinct

- Every weekday morning, use Tiingo ticker metadata for AAPL, MSFT, and NVDA. Report each asset's name and latest available price date.
- Every Monday, use Tiingo ticker metadata for SPY, QQQ, and VTI. Show the common date range available for comparative research.
- On the first business day of each month, use Tiingo ticker metadata for BRK-A and BRK-B. Show their returned names and listing exchanges.
- Every Friday, use Tiingo ticker metadata for KO, PEP, and KDP. Prepare an internal briefing from their returned descriptions.
- Every Monday, use Tiingo ticker metadata for NVDA, AMD, and INTC. Check which available histories cover January 1, 2010 through December 31, 2020.

## How to set up Tiingo ticker metadata 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 metadata**: 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/tickers/meta",
    "input": {
      "ticker": "<ticker>"
    }
  }'
```

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

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

## Tiingo ticker metadata tools and prices

- [Tiingo · Ticker metadata](https://spiral.ai/tools/alexandria/tiingo/tickers/meta) (Alexandria): Up to $0.17459 per run.

## What can you do with Tiingo ticker metadata in Instinct?

Produce a scheduled check of the price-history dates available for a research watchlist. Include Tiingo's returned names and exchanges so each report identifies the assets being checked.

### Check a backtest's starting date

Compare the earliest available dates for SPY, QQQ, and VTI against a proposed January 2000 start. Identify which assets need a shorter research window.

### Find a shared research window

Use the latest starting date and earliest ending date across selected assets to propose a common period for subsequent price analysis.

### Explain securities in a watchlist

Pair symbols with their returned names, descriptions, and listing exchanges so an internal watchlist gives readers context.

### Review symbol mappings

Check whether the names and exchanges returned for BRK-A and BRK-B match the securities intended in an internal research list.

### Check available-history endpoints

Review the latest available price dates for AAPL, MSFT, and NVDA before starting a daily research report.

### Compare business descriptions

Read the returned descriptions for KO, PEP, and KDP side by side to prepare an internal company comparison.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## Tiingo ticker metadata in other agents

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

## More Instinct guides

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

## Questions about Tiingo ticker metadata in Instinct

**Can Instinct use Tiingo ticker metadata?**

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

**How much does Tiingo ticker metadata 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 metadata in Instinct?**

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

**How long does it take to set up Tiingo ticker metadata 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 metadata runs?**

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

**Which markets and asset types does Tiingo cover?**

Tiingo lists US equities, ETFs, mutual funds, and Chinese A-shares in its end-of-day coverage. Check the requested asset's metadata for its available history.

**Are the returned dates the company's founding and listing dates?**

They mark the earliest and latest price data Tiingo has for the asset. Use them to check the available research window, rather than as company milestones.

**When does Tiingo update the underlying daily data?**

Tiingo lists 5:30 PM EST updates for equities and ETFs, and midnight EST for mutual fund NAVs. Those times describe the price data; the metadata end date reports the latest price date available.

**How does Tiingo write share-class symbols?**

Tiingo uses hyphens instead of periods to separate share classes. For example, use BRK-A for Berkshire Hathaway Class A.

**Does Tiingo include delisted securities?**

Tiingo documents support for delisted tickers that have not yet been recycled. That boundary matters when assembling a historical stock universe.

