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

# How to Use Tiingo ticker metadata in Perplexity

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, no API key |

## Prompts to try with Tiingo ticker metadata in Perplexity

- Use Tiingo ticker metadata for AAPL and MSFT. Show each asset's full name, listing exchange, business description, and available-history dates.
- Use Tiingo ticker metadata for SPY, QQQ, and VTI. Which have recorded price history starting on or before January 1, 2000?
- Use Tiingo ticker metadata for BRK-A and BRK-B. Compare their returned names and exchanges.
- Use Tiingo ticker metadata for KO, PEP, and KDP. Summarize the differences in their returned business descriptions.
- Use Tiingo ticker metadata for NVDA, AMD, and INTC. Find the common date range covered by their available price histories.

## How to set up Tiingo ticker metadata in Perplexity

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

### Use the Perplexity connector

1. **Add a remote connector**: In Perplexity, open Plugins in the sidebar (or Customize › Connectors if you don't see Plugins yet). Choose Add custom › Add MCP connector, then Remote. Name it Spiral and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Select the Spiral card on the Plugins page to start sign-in. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

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

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

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

Turn a list of stock symbols into a readable comparison of the businesses and exchanges behind them. Tiingo's available-history dates also let you check whether a proposed research period fits the selected assets.

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

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

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

## Questions about Tiingo ticker metadata in Perplexity

**Can Perplexity use Tiingo ticker metadata?**

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

**How much does Tiingo ticker metadata cost in Perplexity?**

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

**Do I need an Alexandria account to use Tiingo ticker metadata in Perplexity?**

No. Spiral runs Tiingo ticker metadata 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 metadata in Perplexity?**

About two minutes: add a remote connector, then sign in to Spiral and approve.

**Does Perplexity wait while Tiingo ticker metadata runs?**

Tiingo ticker metadata runs in the background. Perplexity 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.

