---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/stock-market
---
# Stock Market

Real-time and historical data for stocks, ETFs, indices, futures, forex, and crypto. Quotes, OHLCV history, side-by-side comparisons, market movers, and analyst insights with technicals, valuations, price targets, and bull/bear theses.

- **Version:** 0.02
- **Categories:** finance

## Skills (9)

### Get Quote (`get_quote`)

Get current price, daily change, volume, and 52-week range for one or more ticker symbols. Supports stocks, ETFs, indices (^GSPC, ^DJI), futures (GC=F, CL=F), forex (EURUSD=X), and crypto (BTC-USD).

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `symbols` | string | Yes | Comma-separated ticker symbols, up to 10 (e.g. "AAPL,MSFT", "^GSPC,^VIX", "GC=F,CL=F", "EURUSD=X", "BTC-USD") |

**Returns:** Current price, daily change, day range, volume, 52-week range, currency, exchange, and instrument type

**Examples:**

*Get Apple and Microsoft stock quotes:*

```json
{
  "symbols": "AAPL,MSFT"
}
```

*Get major indices and VIX:*

```json
{
  "symbols": "^GSPC,^DJI,^IXIC,^VIX"
}
```

*Get gold, oil, and treasury yields:*

```json
{
  "symbols": "GC=F,CL=F,^TNX"
}
```

*Get Bitcoin and EUR/USD:*

```json
{
  "symbols": "BTC-USD,EURUSD=X"
}
```

### Search Symbol (`search_symbol`)

Search for ticker symbols by company name, keyword, or partial match. Returns matching stocks, ETFs, indices, futures, and crypto with exchange, sector, and industry info, plus related news articles.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search term — company name, ticker, or keyword (e.g. "tesla", "gold futures", "S&P 500") |
| `limit` | number | No | Max results (1-20, default 10) [default: 10] |

**Returns:** Matching instruments with metadata and related news articles

**Examples:**

*Find Tesla ticker:*

```json
{
  "query": "tesla"
}
```

*Search for gold futures:*

```json
{
  "query": "gold futures"
}
```

### Price History (`price_history`)

Historical OHLCV (open, high, low, close, volume) data with adjusted close. Supports intervals from 1 minute to 3 months, ranges from 1 day to max history. Optionally includes pre-market and after-hours data. Works for stocks, ETFs, indices, futures, forex, and crypto.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `symbol` | string | Yes | Ticker symbol (e.g. "AAPL", "^GSPC", "GC=F", "EURUSD=X", "BTC-USD") |
| `interval` | string | No | Bar interval: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo (default "1d") [default: "1d"] |
| `range` | string | No | Time range: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max (default "1mo") [default: "1mo"] |
| `include_prepost` | boolean | No | Include pre-market (4:00 AM) and after-hours (8:00 PM) data (default false) [default: false] |

**Returns:** OHLCV bars with metadata, current price, and 52-week range

**Examples:**

*Apple daily prices for the last month:*

```json
{
  "symbol": "AAPL"
}
```

*Tesla weekly prices over 1 year:*

```json
{
  "symbol": "TSLA",
  "interval": "1wk",
  "range": "1y"
}
```

*Intraday 1-minute with extended hours:*

```json
{
  "symbol": "AAPL",
  "interval": "1m",
  "range": "1d",
  "include_prepost": true
}
```

*S&P 500 monthly over 10 years:*

```json
{
  "symbol": "^GSPC",
  "interval": "1mo",
  "range": "10y"
}
```

*Gold futures weekly over 2 years:*

```json
{
  "symbol": "GC=F",
  "interval": "1wk",
  "range": "2y"
}
```

### Dividends & Splits (`dividends_splits`)

Get dividend payment history and stock split records for any equity. Returns individual dividend payments, annual totals, and split ratios. Essential for income investors and total return analysis.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `symbol` | string | Yes | Ticker symbol (e.g. "AAPL", "MSFT", "KO", "JNJ") |
| `range` | string | No | Lookback period: 1y, 2y, 5y, 10y, max (default "5y") [default: "5y"] |

**Returns:** Dividend records with dates and amounts, annual totals, and stock split history with ratios

**Examples:**

*Apple dividends and splits over 5 years:*

```json
{
  "symbol": "AAPL"
}
```

*Coca-Cola full dividend history:*

```json
{
  "symbol": "KO",
  "range": "max"
}
```

### Compare Stocks (`compare_stocks`)

Side-by-side comparison of 2-5 instruments over a time period. Shows current price, period return, high/low, average volume — sorted by performance. Works across asset classes.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `symbols` | string | Yes | Comma-separated list of 2-5 symbols (e.g. "AAPL,MSFT,GOOGL", "GC=F,SI=F,CL=F") |
| `range` | string | No | Comparison period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, ytd, max (default "1mo") [default: "1mo"] |

**Returns:** Instruments ranked by period return with price, change, high/low, average volume, and 52-week range

**Examples:**

*Compare mega-cap tech year-to-date:*

```json
{
  "symbols": "AAPL,MSFT,GOOGL,NVDA,META",
  "range": "ytd"
}
```

*Compare gold vs silver vs oil over 1 year:*

```json
{
  "symbols": "GC=F,SI=F,CL=F",
  "range": "1y"
}
```

### Analyst Insights (`analyst_insights`)

Deep analyst-grade analysis for a stock: multi-timeframe technical signals (short/intermediate/long-term), support/resistance levels, valuation assessment, company scores (innovation, hiring, sustainability, insider sentiment, earnings), analyst price targets, bull/bear thesis, and research reports.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `symbol` | string | Yes | Ticker symbol (e.g. "AAPL", "TSLA", "NVDA") |

**Returns:** Technical analysis (multi-timeframe), key levels, valuation, company scores, analyst target, bull/bear thesis, and research reports

**Examples:**

*Full analyst analysis for Apple:*

```json
{
  "symbol": "AAPL"
}
```

*Technical and valuation analysis for NVIDIA:*

```json
{
  "symbol": "NVDA"
}
```

### Market Overview (`market_overview`)

Full market dashboard in one call — major indices (S&P 500, Dow, Nasdaq, Russell 2000), VIX volatility, Treasury yields (5Y, 10Y, 30Y), commodities (gold, silver, oil, natural gas), forex (DXY, EUR/USD, GBP/USD, USD/JPY), and crypto (BTC, ETH). Choose US or GLOBAL scope for international indices.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `scope` | string | No | US (18 instruments) or GLOBAL (14 instruments including FTSE, DAX, Nikkei, Hang Seng, etc.) (US, GLOBAL) [default: "US"] |

**Returns:** Multi-asset market snapshot organized by category: indices, volatility, bonds, commodities, forex, crypto

**Examples:**

*Full US market dashboard:*

```json
{}
```

*Global markets overview:*

```json
{
  "scope": "GLOBAL"
}
```

### Market Movers (`market_movers`)

Top market movers — day gainers, day losers, most active, trending, undervalued growth stocks, tech growth stocks, undervalued large caps, small cap gainers. Each result includes price, change, volume, market cap, P/E ratios, EPS, dividend yield, analyst rating, and next earnings date.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `category` | string | No | Screener category (default "gainers"). See enum for all options. (gainers, losers, most_active, trending, undervalued_growth, tech_growth, undervalued_large_caps, aggressive_small_caps, small_cap_gainers) [default: "gainers"] |
| `count` | number | No | Number of results (1-25, default 10) [default: 10] |

**Returns:** Ranked stocks with price, change, volume, market cap, P/E (trailing + forward), EPS, dividend yield, 52-week change, analyst rating, and next earnings date

**Examples:**

*Top 10 day gainers:*

```json
{}
```

*Top 25 most active stocks:*

```json
{
  "category": "most_active",
  "count": 25
}
```

*Top losers today:*

```json
{
  "category": "losers"
}
```

*Undervalued growth stocks:*

```json
{
  "category": "undervalued_growth",
  "count": 15
}
```

### Trending Tickers (`trending`)

Most trending tickers right now, enriched with current price data. Shows what the market is watching — stocks, ETFs, and crypto. Supports regional markets.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `region` | string | No | Market region code (default "US"). Examples: US, GB, DE, JP, AU, CA [default: "US"] |
| `limit` | number | No | Number of tickers (1-20, default 10) [default: 10] |

**Returns:** Ranked trending tickers with current price, daily change, volume, and 52-week range

**Examples:**

*Top 10 trending US tickers:*

```json
{}
```

*Top 5 trending UK tickers:*

```json
{
  "region": "GB",
  "limit": 5
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call stock-market get_quote --symbols AAPL,MSFT

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"stock-market","skill":"get_quote","input":{"symbols":"AAPL,MSFT"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I check more than just US stocks?

Yes. The tool covers stocks, ETFs, indices, futures, forex, and crypto, so you can compare assets across markets without switching tools.

### How do I compare several names side by side?

Use `compare_stocks` with two to five symbols and a time range. It ranks the instruments by period return so winners and laggards are obvious.

### What does analyst insights add beyond a quote?

`analyst_insights` adds technical signals, support and resistance, valuation context, company scores, price targets, and bull or bear thesis summaries.

### How do I find the biggest movers or trending tickers?

Use `market_movers` for gainers, losers, and active names, or `trending` when you want hot tickers by region.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs