Stock quotes, charts, financials, options, SEC filings, crypto and macro data. Hosted, no API key.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history.
Stock ticker symbol
Analysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history
Comma-separated list of GraphQL field names to include; omitted = curated default set
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http finance-query https://finance-query.com/mcp
Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbol* | string | Stock ticker symbol |
| analysis_type* | string | Analysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"analysis_type"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"analysis_type": {
"type": "string",
"description": "Analysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history"
}
}
}Get a time-sorted calendar of upcoming financial events (earnings with estimates, ex-dividend and dividend-payment dates, options expirations, and — when FRED is configured — market-wide economic releases) across multiple symbols. Answers 'what's coming up for my portfolio?' in one call.
| Argument | Type | Description |
|---|---|---|
| range* | string | Forward time window: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbols* | string | Comma-separated list of ticker symbols (e.g., "AAPL,MSFT,TSLA") |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Forward time window: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbols": {
"type": "string",
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,TSLA\")"
}
}
}Get historical OHLCV candlestick chart data for one or more stock symbols (comma-separated). A single symbol supports start/end absolute timestamps and returns one chart; multiple symbols return a batch of charts plus per-symbol errors (interval/range only, no start/end).
| Argument | Type | Description |
|---|---|---|
| end | integer | null | End date as Unix timestamp (seconds). Defaults to now when `start` is set. |
| limit | integer | null | Maximum candles per page; omitted = curated default (25) |
| range* | string | Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo). Ignored when `start` is set. |
| start | integer | null | Start date as Unix timestamp (seconds). When provided, overrides `range`. |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbols* | string | One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOG") |
Get a commodity's current quote (e.g. gold, silver, crude oil), provider-routed (Yahoo, keyless).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Commodity symbol (e.g. "GCUSD" for gold, "CLUSD" for crude oil) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Commodity symbol (e.g. \"GCUSD\" for gold, \"CLUSD\" for crude oil)"
}
}
}Get a company's identity/classification profile (name, description, asset type, exchange, currency, country, sector, industry, market capitalization).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get congressional trading disclosures for a symbol. Uses FMP when FMP_API_KEY is set, keyless House PTR filings otherwise.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get top cryptocurrency coins by market cap from CoinGecko (no API key required).
| Argument | Type | Description |
|---|---|---|
| count | integer | null | Number of top coins to return (default: 50, max: 250) |
| limit | integer | null | Maximum coins per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| vs_currency | string | null | Quote currency (default: usd) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Number of top coins to return (default: 50, max: 250)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum coins per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"vs_currency": {
"type": [
"string",
"null"
],
"description": "Quote currency (default: usd)"
}
}
}Get market-wide crypto news (currently FMP only, requires FMP_API_KEY).
| Argument | Type | Description |
|---|---|---|
| count | integer | null | Overall cap on articles fetched (default: 20) |
| limit | integer | null | Maximum articles per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Overall cap on articles fetched (default: 20)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum articles per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}Get dividend history for one or more dividend-paying stocks (comma-separated symbols). A single symbol returns paginated dividend history plus analytics (CAGR, average payment, payout count); multiple symbols return a batch of dividend histories plus per-symbol errors (no analytics for batch).
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum dividend payments per page; omitted = curated default (25) |
| range* | string | Time range: 1y|2y|5y|10y|max (default: max) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbols* | string | One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,KO,JNJ") |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"range"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum dividend payments per page; omitted = curated default (25)"
},
"range": {
"type": "string",
"description": "Time range: 1y|2y|5y|10y|max (default: max)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,KO,JNJ\")"
}
}
}Get a stock's earnings-surprise history (actual vs. estimated EPS).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get an earnings call transcript for a symbol. Provide quarter and year for a specific call, or omit both for the latest (Yahoo only).
| Argument | Type | Description |
|---|---|---|
| year | integer | null | Fiscal year. See `quarter` |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
| quarter* | string | Fiscal quarter (Q1, Q2, Q3, Q4). Required alongside `year` for providers with no "latest" shortcut (Alpha Vantage); Yahoo defaults to latest when omitted |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"quarter"
],
"properties": {
"year": {
"type": [
"integer",
"null"
],
"format": "int32",
"description": "Fiscal year. See `quarter`"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"quarter": {
"type": "string",
"description": "Fiscal quarter (Q1, Q2, Q3, Q4). Required alongside `year` for providers\nwith no \"latest\" shortcut (Alpha Vantage); Yahoo defaults to latest when omitted"
}
}
}Get SEC EDGAR XBRL structured financial data (all reported accounting concepts) for a company. Requires EDGAR_EMAIL env var.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum data points per concept per page; omitted = curated default (25). Applied uniformly across every returned concept. |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated GraphQL sub-fields to include per concept (e.g. "concept,dataPoints"); omitted = curated default set |
| symbol* | string | Stock ticker symbol (e.g., "AAPL", "MSFT", "TSLA") |
| concepts | string | null | Comma-separated XBRL concept names to filter to (e.g. "Revenues,Assets"); omitted = curated defaults (headline financials) |
| taxonomy | string | null | XBRL taxonomy (default: "us-gaap"); also try "ifrs-full" or "dei" |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum data points per concept per page; omitted = curated default (25).\nApplied uniformly across every returned concept."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated GraphQL sub-fields to include per concept (e.g. \"concept,dataPoints\");\nomitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")"
},
"concepts": {
"type": [
"string",
"null"
],
"description": "Comma-separated XBRL concept names to filter to (e.g. \"Revenues,Assets\");\nomitted = curated defaults (headline financials)"
},
"taxonomy": {
"type": [
"string",
"null"
],
"description": "XBRL taxonomy (default: \"us-gaap\"); also try \"ifrs-full\" or \"dei\""
}
}
}Full-text search across SEC EDGAR filings with optional form type and date filters. Requires EDGAR_EMAIL env var.
| Argument | Type | Description |
|---|---|---|
| from | integer | null | Pagination offset; omitted = 0 (first page) |
| size | integer | null | Page size; omitted = 100, max 100 |
| forms | string | null | Comma-separated form types to filter (e.g., "10-K,10-Q,8-K") |
| query* | string | Search query (keywords in filing text) |
| end_date | string | null | End date filter in YYYY-MM-DD format |
| start_date | string | null | Start date filter in YYYY-MM-DD format |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"from": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Pagination offset; omitted = 0 (first page)"
},
"size": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Page size; omitted = 100, max 100"
},
"forms": {
"type": [
"string",
"null"
],
"description": "Comma-separated form types to filter (e.g., \"10-K,10-Q,8-K\")"
},
"query": {
"type": "string",
"description": "Search query (keywords in filing text)"
},
"end_date": {
"type": [
"string",
"null"
],
"description": "End date filter in YYYY-MM-DD format"
},
"start_date": {
"type": [
"string",
"null"
],
"description": "Start date filter in YYYY-MM-DD format"
}
}
}Get SEC filing history and company metadata from EDGAR (up to 1000 most recent filings). Requires EDGAR_EMAIL env var.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum filings per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol (e.g., "AAPL", "MSFT", "TSLA") |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum filings per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")"
}
}
}Get an ETF's profile and holdings (net assets, expense ratio, sector/country weightings, top holdings).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | ETF ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "ETF ticker symbol"
}
}
}Get disclosed executive compensation by year for a symbol.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get fails-to-deliver records for a symbol. Uses FMP when FMP_API_KEY is set, keyless EDGAR otherwise.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get the CNN Fear & Greed Index — market sentiment from extreme fear (0) to extreme greed (100).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}Fetch RSS/Atom news from financial publishers (Bloomberg, WSJ, MarketWatch, FT, SEC, etc.).
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| sources | string | null | Comma-separated feed sources: federal-reserve|sec|marketwatch|cnbc|bloomberg|ft|nyt| guardian|investing|bea|ecb|cfpb|wsj|fortune|businesswire|coindesk|cointelegraph| techcrunch|hackernews|oilprice|calculatedrisk|scmp|nikkei|boe|venturebeat|yc| economist|financialpost|ftlex|ritholtz (default: marketwatch, bloomberg, wsj, fortune) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"sources": {
"type": [
"string",
"null"
],
"description": "Comma-separated feed sources: federal-reserve|sec|marketwatch|cnbc|bloomberg|ft|nyt|\nguardian|investing|bea|ecb|cfpb|wsj|fortune|businesswire|coindesk|cointelegraph|\ntechcrunch|hackernews|oilprice|calculatedrisk|scmp|nikkei|boe|venturebeat|yc|\neconomist|financialpost|ftlex|ritholtz\n(default: marketwatch, bloomberg, wsj, fortune)"
}
}
}Get sectioned text of one SEC filing by accession number (10-K or 8-K). Routes through EDGAR (best-effort HTML extraction) or Polygon when configured.
| Argument | Type | Description |
|---|---|---|
| form* | string | Which filing form to fetch sectioned text for: ten-k | eight-k |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
| accession_number* | string | SEC accession number, e.g. "0000320193-24-000123" |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"accession_number",
"form"
],
"properties": {
"form": {
"type": "string",
"description": "Which filing form to fetch sectioned text for: ten-k | eight-k"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"accession_number": {
"type": "string",
"description": "SEC accession number, e.g. \"0000320193-24-000123\""
}
}
}Get income statement, balance sheet, or cash flow statement for one or more stock symbols (comma-separated). A single symbol returns one statement; multiple symbols return a batch plus per-symbol errors.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| metrics | string | null | Comma-separated list of line-item metrics to filter to; omitted = all reported metrics |
| symbols* | string | One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOGL") |
| frequency* | string | Reporting frequency: annual | quarterly (default: annual) |
| statement* | string | Statement type: income | balance | cashflow |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"statement",
"frequency"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"metrics": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of line-item metrics to filter to; omitted = all reported metrics"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOGL\")"
},
"frequency": {
"type": "string",
"description": "Reporting frequency: annual | quarterly (default: annual)"
},
"statement": {
"type": "string",
"description": "Statement type: income | balance | cashflow"
}
}
}Get a currency pair's current exchange rate, provider-routed (Capability::FOREX).
| Argument | Type | Description |
|---|---|---|
| to* | string | Quote currency code (e.g. "EUR") |
| from* | string | Base currency code (e.g. "USD") |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Quote currency code (e.g. \"EUR\")"
},
"from": {
"type": "string",
"description": "Base currency code (e.g. \"USD\")"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get market-wide forex news (currently FMP only, requires FMP_API_KEY).
| Argument | Type | Description |
|---|---|---|
| count | integer | null | Overall cap on articles fetched (default: 20) |
| limit | integer | null | Maximum articles per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Overall cap on articles fetched (default: 20)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum articles per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}Get FRED macroeconomic time series data (e.g., FEDFUNDS, CPIAUCSL, GDP, UNRATE). Requires FRED_API_KEY env var.
| Argument | Type | Description |
|---|---|---|
| id* | string | FRED series ID (e.g., "FEDFUNDS", "CPIAUCSL", "GDP", "UNRATE") |
| as_of | string | null | Vintage date (YYYY-MM-DD): the series as it stood then, before later revisions; omitted = latest |
| limit | integer | null | Maximum observations per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "FRED series ID (e.g., \"FEDFUNDS\", \"CPIAUCSL\", \"GDP\", \"UNRATE\")"
},
"as_of": {
"type": [
"string",
"null"
],
"description": "Vintage date (YYYY-MM-DD): the series as it stood then, before later revisions; omitted = latest"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum observations per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get a futures contract's current quote, provider-routed (Yahoo, keyless).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Futures contract symbol (e.g. "ESM26" for E-mini S&P June 2026) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Futures contract symbol (e.g. \"ESM26\" for E-mini S&P June 2026)"
}
}
}Get provider-routed analyst upgrades and downgrades for a symbol.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get ownership data for a stock: major holders, institutional/fund ownership, or insider activity.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page for holder types with a list (institutional, mutualfund, insider-transactions, insider-roster); omitted = curated default (25). No-op for major/insider-purchases (no list). |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbol* | string | Stock ticker symbol |
| holder_type* | string | Holder type: major | institutional | mutualfund | insider-transactions | insider-purchases | insider-roster |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"holder_type"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page for holder types with a list (institutional,\nmutualfund, insider-transactions, insider-roster); omitted = curated\ndefault (25). No-op for major/insider-purchases (no list)."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"holder_type": {
"type": "string",
"description": "Holder type: major | institutional | mutualfund | insider-transactions | insider-purchases | insider-roster"
}
}
}Get additions and removals from an index's constituent list.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Index symbol (e.g. ^GSPC) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Index symbol (e.g. ^GSPC)"
}
}
}Get an index's current constituent list, provider-routed (Wikipedia, S&P 500 only).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Index symbol (e.g. "^GSPC" for the S&P 500; Wikipedia-backed, S&P 500 only) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Index symbol (e.g. \"^GSPC\" for the S&P 500; Wikipedia-backed, S&P 500 only)"
}
}
}Get all 42 technical analysis indicators (SMA, EMA, RSI, MACD, Bollinger Bands, Ichimoku, etc.) for one or more stock symbols (comma-separated). A single symbol returns one indicators object; multiple symbols return a paginated batch plus per-symbol errors.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum symbols per page (only applies when multiple symbols given); omitted = curated default (25) |
| range* | string | Time range: 1mo|3mo|6mo|1y|2y|5y (default: 1y) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbols* | string | One or more comma-separated ticker symbols (e.g., "AAPL" or "AAPL,MSFT,GOOG") |
| interval* | string | Candle interval: 1d|1wk|1mo (default: 1d) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"interval",
"range"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum symbols per page (only applies when multiple symbols given); omitted = curated default (25)"
},
"range": {
"type": "string",
"description": "Time range: 1mo|3mo|6mo|1y|2y|5y (default: 1y)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")"
},
"interval": {
"type": "string",
"description": "Candle interval: 1d|1wk|1mo (default: 1d)"
}
}
}Get world market indices (S&P 500, DAX, Nikkei, etc.), optionally filtered by region.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| region* | string | Region: americas|europe|asia-pacific|middle-east-africa|currencies (default: all) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"region": {
"type": "string",
"description": "Region: americas|europe|asia-pacific|middle-east-africa|currencies (default: all)"
}
}
}Get comprehensive industry data (overview, performance, top companies) for a specific industry slug.
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| industry* | string | Industry slug (e.g., semiconductors, biotechnology, banks-diversified) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"industry"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"industry": {
"type": "string",
"description": "Industry slug (e.g., semiconductors, biotechnology, banks-diversified)"
}
}
}Get trailing-twelve-month key metrics for a symbol.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get a market-wide event calendar over a date range: earnings, IPOs, dividends, splits, economic releases, market holidays, or live exchange open/closed status. Unlike get_calendar (per-symbol), this spans the whole market.
| Argument | Type | Description |
|---|---|---|
| to | string | null | End date (YYYY-MM-DD); ignored by market-holiday/market-status |
| from | string | null | Start date (YYYY-MM-DD); ignored by market-holiday/market-status |
| kind* | string | Which market-wide calendar to fetch: earnings | ipo | dividend | split | economic | market-holiday | market-status |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind"
],
"properties": {
"to": {
"type": [
"string",
"null"
],
"description": "End date (YYYY-MM-DD); ignored by market-holiday/market-status"
},
"from": {
"type": [
"string",
"null"
],
"description": "Start date (YYYY-MM-DD); ignored by market-holiday/market-status"
},
"kind": {
"type": "string",
"description": "Which market-wide calendar to fetch: earnings | ipo | dividend | split | economic | market-holiday | market-status"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get current market hours and open/closed status for a region.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| region* | string | Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"region": {
"type": "string",
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)"
}
}
}Get market overview with major indices and currencies for a region.
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| region* | string | Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"region": {
"type": "string",
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)"
}
}
}Get recent news. If a symbol is provided, returns news for that stock; otherwise returns general market news.
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| limit | integer | null | Maximum articles per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbol | string | null | Stock ticker symbol (optional; omit for general market news) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum articles per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": [
"string",
"null"
],
"description": "Stock ticker symbol (optional; omit for general market news)"
}
}
}Get the options chain for a symbol. Provide an expiration timestamp to get a specific expiry, or omit for the nearest expiration.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum contracts per side (calls/puts) per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor` (applied to both calls and puts); omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbol* | string | Stock ticker symbol |
| expiration | integer | null | Expiration date as Unix timestamp in seconds (optional; defaults to nearest expiration) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum contracts per side (calls/puts) per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor` (applied to both calls and puts); omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"expiration": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Expiration date as Unix timestamp in seconds (optional; defaults to nearest expiration)"
}
}
}Get a company's own press releases, distinct from get_news (press coverage). Routes through EDGAR 8-K exhibits, falling back to FMP/Alpha Vantage when configured.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum number of releases to return (default: 10) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum number of releases to return (default: 10)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get a stock's consensus analyst price target (high/low/mean/median).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get analyst price-target counts and averages per window (FMP only, requires FMP_API_KEY).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get a DeFi protocol's total value locked and per-chain split (DefiLlama, keyless).
| Argument | Type | Description |
|---|---|---|
| id* | string | CoinGecko coin id (e.g. aave) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "CoinGecko coin id (e.g. aave)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get a DeFi protocol's TVL history, oldest first (DefiLlama, keyless).
| Argument | Type | Description |
|---|---|---|
| id* | string | CoinGecko coin id (e.g. aave) |
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "CoinGecko coin id (e.g. aave)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get current quote and company data (price, market cap, PE ratio, 52-week range, etc.) for one or more stock symbols (comma-separated). A single symbol returns one quote object; multiple symbols return a paginated batch of quotes plus per-symbol errors.
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| limit | integer | null | Maximum symbols per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbols* | string | Comma-separated list of ticker symbols (e.g., "AAPL,MSFT,GOOG") |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum symbols per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")"
}
}
}Get a stock's consensus analyst rating rollup (strong buy/buy/hold/sell/strong sell counts and a headline consensus label).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get trailing-twelve-month financial ratios for a symbol.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get similar stock recommendations and analyst ratings for a symbol.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum number of recommendations to return (default: 5) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum number of recommendations to return (default: 5)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get risk analytics: VaR (95/99%), Sharpe/Sortino/Calmar ratios, beta, and maximum drawdown for a symbol.
| Argument | Type | Description |
|---|---|---|
| range* | string | Time range: 1y|2y|5y (default: 1y) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbol* | string | Stock ticker symbol |
| interval* | string | Candle interval: 1d|1wk (default: 1d) |
| benchmark | string | null | Benchmark symbol for beta calculation (e.g., "SPY") |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"interval",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Time range: 1y|2y|5y (default: 1y)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"interval": {
"type": "string",
"description": "Candle interval: 1d|1wk (default: 1d)"
},
"benchmark": {
"type": [
"string",
"null"
],
"description": "Benchmark symbol for beta calculation (e.g., \"SPY\")"
}
}
}Get risk factors extracted from a symbol's SEC filings. Routes through EDGAR (best-effort HTML extraction) or Polygon when configured.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get comprehensive sector data (overview, performance, top companies, ETFs) for one of the 11 GICS sectors.
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| sector* | string | Sector slug: technology|financial-services|consumer-cyclical|communication-services| healthcare|industrials|consumer-defensive|energy|basic-materials|real-estate|utilities |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sector"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"sector": {
"type": "string",
"description": "Sector slug: technology|financial-services|consumer-cyclical|communication-services|\nhealthcare|industrials|consumer-defensive|energy|basic-materials|real-estate|utilities"
}
}
}Get price/earnings ratios by market sector, provider-routed (Yahoo screener fan-out, keyless).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get aggregate performance for every market sector, provider-routed (Yahoo screener fan-out, keyless). Distinct from get_sector (per-sector Yahoo-only shortcut).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get sector performance per session, most recent first.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Sessions to return; omitted = 30 |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Sessions to return; omitted = 30"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get daily FINRA short-sale volume for a symbol (keyless).
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Maximum entries per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum entries per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get lightweight close-price sparklines for multiple symbols. Faster and smaller than get_charts — use when you only need price direction/trend across many symbols.
| Argument | Type | Description |
|---|---|---|
| range* | string | Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbols* | string | Comma-separated list of ticker symbols (e.g., "AAPL,MSFT,GOOG") |
| interval* | string | Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"interval",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")"
},
"interval": {
"type": "string",
"description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)"
}
}
}Get historical stock split history for a symbol.
| Argument | Type | Description |
|---|---|---|
| range* | string | Time range: 1y|2y|5y|10y|max (default: max) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol",
"range"
],
"properties": {
"range": {
"type": "string",
"description": "Time range: 1y|2y|5y|10y|max (default: max)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get reference detail for one symbol (name, exchange, SIC code, employees, list date).
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| symbol* | string | Stock ticker symbol |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
}
}
}Get earnings call transcripts for a company. Returns paragraph-by-paragraph text (speaker, timestamp, text), paginated via paragraph_limit/paragraph_cursor since a full call can be tens of thousands of tokens.
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| limit | integer | null | Maximum number of transcripts to return (default: all) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| symbol* | string | Stock ticker symbol |
| paragraph_limit | integer | null | Maximum transcript paragraphs per page; omitted = curated default (25). A full call's `text` is returned as paginated paragraphs, not one giant blob |
| paragraph_cursor | string | null | Opaque continuation token from a previous response's paragraphs `pageInfo.endCursor`; omitted = first page |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum number of transcripts to return (default: all)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbol": {
"type": "string",
"description": "Stock ticker symbol"
},
"paragraph_limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum transcript paragraphs per page; omitted = curated default (25). A\nfull call's `text` is returned as paginated paragraphs, not one giant blob"
},
"paragraph_cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's paragraphs `pageInfo.endCursor`; omitted = first page"
}
}
}Get US Treasury securities auction results (bid-to-cover ratio, high yield or discount rate, and the primary-dealer/direct/indirect bidder split), newest first. Set upcoming=true for the announced schedule of auctions not yet held. No API key required.
| Argument | Type | Description |
|---|---|---|
| to | string | null | Latest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true |
| from | string | null | Earliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true |
| count | integer | null | Total auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them |
| limit | integer | null | Maximum rows per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
| upcoming | boolean | null | Return the not-yet-held auction schedule instead of auction records |
| security_term |
Get US Treasury yield curve data (1m through 30y) for a given year. No API key required.
| Argument | Type | Description |
|---|---|---|
| year | integer | null | Year to fetch yield curve data for (default: current year) |
| limit | integer | null | Maximum rows per page; omitted = curated default (25) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = all fields |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"year": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Year to fetch yield curve data for (default: current year)"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum rows per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
}
}
}Get currently trending stock tickers for a region.
| Argument | Type | Description |
|---|---|---|
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| region* | string | Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"region": {
"type": "string",
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)"
}
}
}Discover tickers filtered by type (equity, ETF, mutual fund, index, future, currency, cryptocurrency).
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| logo | boolean | null | Include logo URLs (requires an additional upstream API call); default: false |
| query* | string | Search query (company name or ticker symbol) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| query_type* | string | Filter by type: equity|etf|mutualfund|index|future|currency|cryptocurrency (default: all) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"query_type"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"logo": {
"type": [
"boolean",
"null"
],
"description": "Include logo URLs (requires an additional upstream API call); default: false"
},
"query": {
"type": "string",
"description": "Search query (company name or ticker symbol)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"query_type": {
"type": "string",
"description": "Filter by type: equity|etf|mutualfund|index|future|currency|cryptocurrency (default: all)"
}
}
}Get results from a predefined stock screener (e.g., most-actives, day-gainers, undervalued-growth-stocks).
| Argument | Type | Description |
|---|---|---|
| count | integer | null | Number of results to return (default: 25, max: 250) |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
| screener_type* | string | Screener type: most-actives | day-gainers | day-losers | growth-technology-stocks | undervalued-growth-stocks | undervalued-large-caps | aggressive-small-caps | small-cap-gainers | most-shorted-stocks | high-yield-bond | top-mutual-funds | conservative-foreign-funds | portfolio-anchors | solid-large-growth-funds | solid-midcap-growth-funds |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"screener_type"
],
"properties": {
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Number of results to return (default: 25, max: 250)"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"screener_type": {
"type": "string",
"description": "Screener type: most-actives | day-gainers | day-losers | growth-technology-stocks |\nundervalued-growth-stocks | undervalued-large-caps | aggressive-small-caps |\nsmall-cap-gainers | most-shorted-stocks | high-yield-bond | top-mutual-funds |\nconservative-foreign-funds | portfolio-anchors | solid-large-growth-funds |\nsolid-midcap-growth-funds"
}
}
}Search for stocks, ETFs, and companies by name or ticker symbol.
| Argument | Type | Description |
|---|---|---|
| lang | string | null | Target language for translated text fields (BCP 47, e.g. "ja", "zh-Hant"); English or omitted = no translation |
| limit | integer | null | Maximum quotes per page; omitted = curated default (25) |
| query* | string | Search query string (company name or ticker symbol) |
| cursor | string | null | Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page |
| fields | string | null | Comma-separated list of GraphQL field names to include; omitted = curated default set |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"lang": {
"type": [
"string",
"null"
],
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum quotes per page; omitted = curated default (25)"
},
"query": {
"type": "string",
"description": "Search query string (company name or ticker symbol)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.
| interval* |
| string |
| Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols",
"interval",
"range"
],
"properties": {
"end": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "End date as Unix timestamp (seconds). Defaults to now when `start` is set."
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum candles per page; omitted = curated default (25)"
},
"range": {
"type": "string",
"description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo). Ignored when `start` is set."
},
"start": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Start date as Unix timestamp (seconds). When provided, overrides `range`."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set"
},
"symbols": {
"type": "string",
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")"
},
"interval": {
"type": "string",
"description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)"
}
}
}| string | null |
| Security term filter as Treasury spells it (e.g. "13-Week"); ignored when `upcoming` is true |
| security_type | string | null | Security class filter ("Bill", "Note", "Bond"); ignored when `upcoming` is true |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": [
"string",
"null"
],
"description": "Latest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true"
},
"from": {
"type": [
"string",
"null"
],
"description": "Earliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true"
},
"count": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Total auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them"
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Maximum rows per page; omitted = curated default (25)"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page"
},
"fields": {
"type": [
"string",
"null"
],
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields"
},
"upcoming": {
"type": [
"boolean",
"null"
],
"description": "Return the not-yet-held auction schedule instead of auction records"
},
"security_term": {
"type": [
"string",
"null"
],
"description": "Security term filter as Treasury spells it (e.g. \"13-Week\"); ignored when `upcoming` is true"
},
"security_type": {
"type": [
"string",
"null"
],
"description": "Security class filter (\"Bill\", \"Note\", \"Bond\"); ignored when `upcoming` is true"
}
}
}