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

# How to Use Tiingo ticker metadata in opencode

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 opencode

- Use Tiingo ticker metadata for AAPL and MSFT to build an internal comparison view with their names, exchanges, descriptions, and available-history dates.
- Use Tiingo ticker metadata for SPY, QQQ, and VTI to check whether the backtest in this project can start on January 1, 2000.
- Use Tiingo ticker metadata for BRK-A and BRK-B to review the Berkshire Hathaway symbol mappings in this project's watchlist.
- Use Tiingo ticker metadata for NVDA and AMD to add their returned descriptions and listing exchanges to this project's internal research screen.
- Use Tiingo ticker metadata for KO, PEP, and KDP to calculate a shared available-history window in memory and show it in the research view.

## How to set up Tiingo ticker metadata in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

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

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

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

Add security names, descriptions, exchanges, and available-history dates to an internal research application. Use Tiingo metadata to check the project's symbol mappings and proposed analysis windows.

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

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

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

## Questions about Tiingo ticker metadata in opencode

**Can opencode use Tiingo ticker metadata?**

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

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

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

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

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 opencode?**

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

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

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

