[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Tiingo financial news](https://spiral.ai/integrations/claude-code/tiingo-financial-news)

# How to Use Tiingo financial news in Claude Code

Tiingo financial news returns article titles, links, descriptions, source domains, matched tickers and tags, plus publication and crawl times. Use it to prepare company news briefs, compare publisher coverage or build an event reading list.

|  |  |
| --- | --- |
| Model | Tiingo financial news |
| 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 financial news in Claude Code

- Use Tiingo financial news to retrieve AAPL articles from the past seven days, then build an internal reading-list view in this project with titles, descriptions and publisher links.
- Use Tiingo financial news to fetch MSFT and GOOGL articles from the past week. Add a comparison view showing the returned article counts and source domains for each ticker.
- Use Tiingo financial news to retrieve recent NVDA articles. Implement an in-memory topic view using the returned tags, with a publisher link beside every headline.
- Use Tiingo financial news to fetch BA articles from the past fourteen days. Add a timeline component ordered by publication time and display crawl time separately.
- Use Tiingo financial news to retrieve JPM articles from the past seven days. Build an internal source-domain table from the live response and label its counts as retrieved articles.

## How to set up Tiingo financial news in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 financial news**: 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/news/search",
    "input": {
      "tags": "<tags>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Tiingo financial news on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Tiingo financial news tools and prices

- [Tiingo · News search](https://spiral.ai/tools/alexandria/tiingo/news/search) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tags |  | — | Comma-separated Tiingo topic tags, such as Earnings,Technology. Up to 20. |
| limit | 1 to 100 | — | Articles to return, from 1 to 100. Tiingo's default is 100. One request either way. |
| offset | 0 to 10000 | — | Articles to skip, for paging with limit. Default 0. |
| sortBy | publishedDate, crawlDate | — | publishedDate (the default) or crawlDate, newest first. |
| source |  | — | Comma-separated source domains, such as bloomberg.com,reuters.com. Up to 20. |
| endDate |  | — | YYYY-MM-DD. Articles published on or before this day. |

## What can you do with Tiingo financial news in Claude Code?

Build a company news view that shows Tiingo headlines beside their publisher links and descriptions. A coding agent can use live results to implement topic grouping and publisher comparisons in your project.

### Morning company brief

Turn recent AAPL, MSFT and GOOGL articles into a short reading list with publisher links and descriptions.

### Earnings reading queue

Review NVDA articles from the past week and select descriptions discussing earnings, guidance or demand for closer reading.

### Competitor coverage comparison

Compare the subjects covered in KO and PEP articles over the same period, citing examples from the returned results.

### Publisher coverage audit

Count source domains in recent JPM results to see which publishers dominate the retrieved reading list.

### Company event chronology

Arrange BA headlines by publication time to build a linked chronology of recent coverage.

### Topic review

Group recent AMD articles by their returned topic tags, then inspect descriptions to identify subjects worth researching.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Tiingo financial news in other agents

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

## More Claude Code guides

- [Stock Analysis ticker search](https://spiral.ai/integrations/claude-code/stock-analysis-ticker-search)
- [Tiingo historical stock prices](https://spiral.ai/integrations/claude-code/tiingo-historical-stock-prices)
- [Stock Analysis stock statistics](https://spiral.ai/integrations/claude-code/stock-analysis-stock-statistics)
- [Tiingo ticker metadata](https://spiral.ai/integrations/claude-code/tiingo-ticker-metadata)
- [Stock Analysis stock screener](https://spiral.ai/integrations/claude-code/stock-analysis-stock-screener)
- [Tiingo ticker search](https://spiral.ai/integrations/claude-code/tiingo-ticker-search)

## Questions about Tiingo financial news in Claude Code

**Can Claude Code use Tiingo financial news?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Tiingo financial news like any built-in tool.

**How much does Tiingo financial news cost in Claude Code?**

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

**Do I need an Alexandria account to use Tiingo financial news in Claude Code?**

No. Spiral runs Tiingo financial news 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 financial news in Claude Code?**

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

**Does Claude Code wait while Tiingo financial news runs?**

Tiingo financial news runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**What information comes back for a news article?**

Tiingo returns a title, publisher link, description, source domain, matched asset tickers, topic tags, publication date and crawl date. These support a linked reading list or a comparison of coverage.

**Does Tiingo include financial blogs?**

Yes. Tiingo collects from financial news sites and financial blogs, so results can include commentary alongside news reporting.

**How fresh is the news?**

Tiingo says articles are added in real time as they are discovered. That describes discovery by Tiingo, rather than a guaranteed delay from the publisher's release.

**How far back can I search?**

Tiingo's standard news offering provides three months of queryable history. Older research requires separate historical coverage.

**What does an article's crawl time mean?**

Crawl time is the UTC timestamp when Tiingo added the article to its database. Use it when the question concerns when Tiingo discovered a story.

