FinanceQuery
Stock quotes, charts, financials, options, SEC filings, crypto and macro data. Hosted, no API key.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"finance-query": {
"url": "https://finance-query.com/mcp"
}
}
}Remote endpoints
https://finance-query.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (64)
🟢get_analysis(analysis_type, fields, symbol)
Get analyst data for a stock: recommendation trends, upgrades/downgrades, earnings estimates, or earnings history.
Input Schema
{
"type": "object",
"properties": {
"analysis_type": {
"description": "Analysis type: recommendations | upgrades-downgrades | earnings-estimate | earnings-history",
"type": "string"
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol",
"analysis_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_calendar(fields, range, symbols)
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.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"range": {
"description": "Forward time window: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)",
"type": "string"
},
"symbols": {
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,TSLA\")",
"type": "string"
}
},
"required": [
"symbols",
"range"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_chart(cursor, end, fields, interval, limit, ...)
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).
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"end": {
"description": "End date as Unix timestamp (seconds). Defaults to now when `start` is set.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"interval": {
"description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)",
"type": "string"
},
"limit": {
"description": "Maximum candles per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"range": {
"description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo). Ignored when `start` is set.",
"type": "string"
},
"start": {
"description": "Start date as Unix timestamp (seconds). When provided, overrides `range`.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"symbols": {
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")",
"type": "string"
}
},
"required": [
"symbols",
"interval",
"range"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_commodity(fields, symbol)
Get a commodity's current quote (e.g. gold, silver, crude oil), provider-routed (Yahoo, keyless).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Commodity symbol (e.g. \"GCUSD\" for gold, \"CLUSD\" for crude oil)",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_company_profile(fields, symbol)
Get a company's identity/classification profile (name, description, asset type, exchange, currency, country, sector, industry, market capitalization).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_congressional_trades(cursor, fields, limit, symbol)
Get congressional trading disclosures for a symbol. Uses FMP when FMP_API_KEY is set, keyless House PTR filings otherwise.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_crypto(count, cursor, fields, limit, vs_currency)
Get top cryptocurrency coins by market cap from CoinGecko (no API key required).
Input Schema
{
"type": "object",
"properties": {
"count": {
"description": "Number of top coins to return (default: 50, max: 250)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum coins per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"vs_currency": {
"description": "Quote currency (default: usd)",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_crypto_news(count, cursor, fields, limit)
Get market-wide crypto news (currently FMP only, requires FMP_API_KEY).
Input Schema
{
"type": "object",
"properties": {
"count": {
"description": "Overall cap on articles fetched (default: 20)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum articles per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_dividends(cursor, fields, limit, range, symbols)
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).
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum dividend payments per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"range": {
"description": "Time range: 1y|2y|5y|10y|max (default: max)",
"type": "string"
},
"symbols": {
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,KO,JNJ\")",
"type": "string"
}
},
"required": [
"symbols",
"range"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_earnings_surprises(fields, symbol)
Get a stock's earnings-surprise history (actual vs. estimated EPS).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_earnings_transcript(fields, quarter, symbol, year)
Get an earnings call transcript for a symbol. Provide quarter and year for a specific call, or omit both for the latest (Yahoo only).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"quarter": {
"description": "Fiscal quarter (Q1, Q2, Q3, Q4). Required alongside `year` for providers\nwith no \"latest\" shortcut (Alpha Vantage); Yahoo defaults to latest when omitted",
"type": "string"
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
},
"year": {
"description": "Fiscal year. See `quarter`",
"format": "int32",
"type": [
"integer",
"null"
]
}
},
"required": [
"symbol",
"quarter"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_edgar_facts(concepts, cursor, fields, limit, symbol, ...)
Get SEC EDGAR XBRL structured financial data (all reported accounting concepts) for a company. Requires EDGAR_EMAIL env var.
Input Schema
{
"type": "object",
"properties": {
"concepts": {
"description": "Comma-separated XBRL concept names to filter to (e.g. \"Revenues,Assets\");\nomitted = curated defaults (headline financials)",
"type": [
"string",
"null"
]
},
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated GraphQL sub-fields to include per concept (e.g. \"concept,dataPoints\");\nomitted = curated default set",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum data points per concept per page; omitted = curated default (25).\nApplied uniformly across every returned concept.",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")",
"type": "string"
},
"taxonomy": {
"description": "XBRL taxonomy (default: \"us-gaap\"); also try \"ifrs-full\" or \"dei\"",
"type": [
"string",
"null"
]
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_edgar_search(end_date, forms, from, query, size, ...)
Full-text search across SEC EDGAR filings with optional form type and date filters. Requires EDGAR_EMAIL env var.
Input Schema
{
"type": "object",
"properties": {
"end_date": {
"description": "End date filter in YYYY-MM-DD format",
"type": [
"string",
"null"
]
},
"forms": {
"description": "Comma-separated form types to filter (e.g., \"10-K,10-Q,8-K\")",
"type": [
"string",
"null"
]
},
"from": {
"description": "Pagination offset; omitted = 0 (first page)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"query": {
"description": "Search query (keywords in filing text)",
"type": "string"
},
"size": {
"description": "Page size; omitted = 100, max 100",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"start_date": {
"description": "Start date filter in YYYY-MM-DD format",
"type": [
"string",
"null"
]
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_edgar_submissions(cursor, fields, limit, symbol)
Get SEC filing history and company metadata from EDGAR (up to 1000 most recent filings). Requires EDGAR_EMAIL env var.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum filings per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol (e.g., \"AAPL\", \"MSFT\", \"TSLA\")",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_etf_profile(fields, symbol)
Get an ETF's profile and holdings (net assets, expense ratio, sector/country weightings, top holdings).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "ETF ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_executive_compensation(cursor, fields, limit, symbol)
Get disclosed executive compensation by year for a symbol.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_fails_to_deliver(cursor, fields, limit, symbol)
Get fails-to-deliver records for a symbol. Uses FMP when FMP_API_KEY is set, keyless EDGAR otherwise.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_fear_and_greed(fields)
Get the CNN Fear & Greed Index — market sentiment from extreme fear (0) to extreme greed (100).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_feeds(cursor, fields, limit, sources)
Fetch RSS/Atom news from financial publishers (Bloomberg, WSJ, MarketWatch, FT, SEC, etc.).
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"sources": {
"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)",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_filing_sections(accession_number, fields, form, symbol)
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.
Input Schema
{
"type": "object",
"properties": {
"accession_number": {
"description": "SEC accession number, e.g. \"0000320193-24-000123\"",
"type": "string"
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"form": {
"description": "Which filing form to fetch sectioned text for: ten-k | eight-k",
"type": "string"
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol",
"accession_number",
"form"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_financials(fields, frequency, metrics, statement, symbols)
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.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"frequency": {
"description": "Reporting frequency: annual | quarterly (default: annual)",
"type": "string"
},
"metrics": {
"description": "Comma-separated list of line-item metrics to filter to; omitted = all reported metrics",
"type": [
"string",
"null"
]
},
"statement": {
"description": "Statement type: income | balance | cashflow",
"type": "string"
},
"symbols": {
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOGL\")",
"type": "string"
}
},
"required": [
"symbols",
"statement",
"frequency"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_forex(fields, from, to)
Get a currency pair's current exchange rate, provider-routed (Capability::FOREX).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"from": {
"description": "Base currency code (e.g. \"USD\")",
"type": "string"
},
"to": {
"description": "Quote currency code (e.g. \"EUR\")",
"type": "string"
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_forex_news(count, cursor, fields, limit)
Get market-wide forex news (currently FMP only, requires FMP_API_KEY).
Input Schema
{
"type": "object",
"properties": {
"count": {
"description": "Overall cap on articles fetched (default: 20)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum articles per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_fred_series(as_of, cursor, fields, id, limit)
Get FRED macroeconomic time series data (e.g., FEDFUNDS, CPIAUCSL, GDP, UNRATE). Requires FRED_API_KEY env var.
Input Schema
{
"type": "object",
"properties": {
"as_of": {
"description": "Vintage date (YYYY-MM-DD): the series as it stood then, before later revisions; omitted = latest",
"type": [
"string",
"null"
]
},
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"id": {
"description": "FRED series ID (e.g., \"FEDFUNDS\", \"CPIAUCSL\", \"GDP\", \"UNRATE\")",
"type": "string"
},
"limit": {
"description": "Maximum observations per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_futures(fields, symbol)
Get a futures contract's current quote, provider-routed (Yahoo, keyless).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Futures contract symbol (e.g. \"ESM26\" for E-mini S&P June 2026)",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_grading_actions(cursor, fields, limit, symbol)
Get provider-routed analyst upgrades and downgrades for a symbol.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_holders(cursor, fields, holder_type, limit, symbol)
Get ownership data for a stock: major holders, institutional/fund ownership, or insider activity.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"holder_type": {
"description": "Holder type: major | institutional | mutualfund | insider-transactions | insider-purchases | insider-roster",
"type": "string"
},
"limit": {
"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).",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol",
"holder_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_index_constituent_changes(cursor, fields, limit, symbol)
Get additions and removals from an index's constituent list.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Index symbol (e.g. ^GSPC)",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_index_constituents(fields, symbol)
Get an index's current constituent list, provider-routed (Wikipedia, S&P 500 only).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Index symbol (e.g. \"^GSPC\" for the S&P 500; Wikipedia-backed, S&P 500 only)",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_indicators(cursor, fields, interval, limit, range, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"interval": {
"description": "Candle interval: 1d|1wk|1mo (default: 1d)",
"type": "string"
},
"limit": {
"description": "Maximum symbols per page (only applies when multiple symbols given); omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"range": {
"description": "Time range: 1mo|3mo|6mo|1y|2y|5y (default: 1y)",
"type": "string"
},
"symbols": {
"description": "One or more comma-separated ticker symbols (e.g., \"AAPL\" or \"AAPL,MSFT,GOOG\")",
"type": "string"
}
},
"required": [
"symbols",
"interval",
"range"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_indices(fields, region)
Get world market indices (S&P 500, DAX, Nikkei, etc.), optionally filtered by region.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"region": {
"description": "Region: americas|europe|asia-pacific|middle-east-africa|currencies (default: all)",
"type": "string"
}
},
"required": [
"region"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_industry(fields, industry, lang)
Get comprehensive industry data (overview, performance, top companies) for a specific industry slug.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"industry": {
"description": "Industry slug (e.g., semiconductors, biotechnology, banks-diversified)",
"type": "string"
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
}
},
"required": [
"industry"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_key_metrics_ttm(fields, symbol)
Get trailing-twelve-month key metrics for a symbol.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_market_calendar(fields, from, kind, to)
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.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"from": {
"description": "Start date (YYYY-MM-DD); ignored by market-holiday/market-status",
"type": [
"string",
"null"
]
},
"kind": {
"description": "Which market-wide calendar to fetch: earnings | ipo | dividend | split | economic | market-holiday | market-status",
"type": "string"
},
"to": {
"description": "End date (YYYY-MM-DD); ignored by market-holiday/market-status",
"type": [
"string",
"null"
]
}
},
"required": [
"kind"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_market_hours(fields, region)
Get current market hours and open/closed status for a region.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"region": {
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)",
"type": "string"
}
},
"required": [
"region"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_market_summary(fields, lang, region)
Get market overview with major indices and currencies for a region.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
},
"region": {
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)",
"type": "string"
}
},
"required": [
"region"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_news(cursor, fields, lang, limit, symbol)
Get recent news. If a symbol is provided, returns news for that stock; otherwise returns general market news.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum articles per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol (optional; omit for general market news)",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_options(cursor, expiration, fields, limit, symbol)
Get the options chain for a symbol. Provide an expiration timestamp to get a specific expiry, or omit for the nearest expiration.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor` (applied to both calls and puts); omitted = first page",
"type": [
"string",
"null"
]
},
"expiration": {
"description": "Expiration date as Unix timestamp in seconds (optional; defaults to nearest expiration)",
"format": "int64",
"type": [
"integer",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum contracts per side (calls/puts) per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_press_releases(fields, limit, symbol)
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.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum number of releases to return (default: 10)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_price_target_consensus(fields, symbol)
Get a stock's consensus analyst price target (high/low/mean/median).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_price_target_summary(fields, symbol)
Get analyst price-target counts and averages per window (FMP only, requires FMP_API_KEY).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_protocol_tvl(fields, id)
Get a DeFi protocol's total value locked and per-chain split (DefiLlama, keyless).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"id": {
"description": "CoinGecko coin id (e.g. aave)",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_protocol_tvl_history(cursor, fields, id, limit)
Get a DeFi protocol's TVL history, oldest first (DefiLlama, keyless).
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"id": {
"description": "CoinGecko coin id (e.g. aave)",
"type": "string"
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_quote(cursor, fields, lang, limit, symbols)
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.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum symbols per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbols": {
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")",
"type": "string"
}
},
"required": [
"symbols"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_rating_consensus(fields, symbol)
Get a stock's consensus analyst rating rollup (strong buy/buy/hold/sell/strong sell counts and a headline consensus label).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_ratios_ttm(fields, symbol)
Get trailing-twelve-month financial ratios for a symbol.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_recommendations(fields, limit, symbol)
Get similar stock recommendations and analyst ratings for a symbol.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum number of recommendations to return (default: 5)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_risk(benchmark, fields, interval, range, symbol)
Get risk analytics: VaR (95/99%), Sharpe/Sortino/Calmar ratios, beta, and maximum drawdown for a symbol.
Input Schema
{
"type": "object",
"properties": {
"benchmark": {
"description": "Benchmark symbol for beta calculation (e.g., \"SPY\")",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"interval": {
"description": "Candle interval: 1d|1wk (default: 1d)",
"type": "string"
},
"range": {
"description": "Time range: 1y|2y|5y (default: 1y)",
"type": "string"
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol",
"interval",
"range"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_risk_factors(fields, symbol)
Get risk factors extracted from a symbol's SEC filings. Routes through EDGAR (best-effort HTML extraction) or Polygon when configured.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_sector(fields, lang, sector)
Get comprehensive sector data (overview, performance, top companies, ETFs) for one of the 11 GICS sectors.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
},
"sector": {
"description": "Sector slug: technology|financial-services|consumer-cyclical|communication-services|\nhealthcare|industrials|consumer-defensive|energy|basic-materials|real-estate|utilities",
"type": "string"
}
},
"required": [
"sector"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_sector_pe(fields)
Get price/earnings ratios by market sector, provider-routed (Yahoo screener fan-out, keyless).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_sector_performance(fields)
Get aggregate performance for every market sector, provider-routed (Yahoo screener fan-out, keyless). Distinct from get_sector (per-sector Yahoo-only shortcut).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_sector_performance_history(fields, limit)
Get sector performance per session, most recent first.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Sessions to return; omitted = 30",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_short_volume(cursor, fields, limit, symbol)
Get daily FINRA short-sale volume for a symbol (keyless).
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum entries per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_spark(fields, interval, range, symbols)
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.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"interval": {
"description": "Candle interval: 1m|5m|15m|30m|1h|1d|1wk|1mo|3mo (default: 1d)",
"type": "string"
},
"range": {
"description": "Time range: 1d|5d|1mo|3mo|6mo|1y|2y|5y|10y|ytd|max (default: 1mo)",
"type": "string"
},
"symbols": {
"description": "Comma-separated list of ticker symbols (e.g., \"AAPL,MSFT,GOOG\")",
"type": "string"
}
},
"required": [
"symbols",
"interval",
"range"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_splits(fields, range, symbol)
Get historical stock split history for a symbol.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"range": {
"description": "Time range: 1y|2y|5y|10y|max (default: max)",
"type": "string"
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol",
"range"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_symbol_details(fields, symbol)
Get reference detail for one symbol (name, exchange, SIC code, employees, list date).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_transcripts(fields, lang, limit, paragraph_cursor, paragraph_limit, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum number of transcripts to return (default: all)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"paragraph_cursor": {
"description": "Opaque continuation token from a previous response's paragraphs `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"paragraph_limit": {
"description": "Maximum transcript paragraphs per page; omitted = curated default (25). A\nfull call's `text` is returned as paginated paragraphs, not one giant blob",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"symbol": {
"description": "Stock ticker symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_treasury_auctions(count, cursor, fields, from, limit, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"count": {
"description": "Total auctions fetched from Treasury, newest first (default: 100); `limit`/`cursor` page through them",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"from": {
"description": "Earliest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum rows per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"security_term": {
"description": "Security term filter as Treasury spells it (e.g. \"13-Week\"); ignored when `upcoming` is true",
"type": [
"string",
"null"
]
},
"security_type": {
"description": "Security class filter (\"Bill\", \"Note\", \"Bond\"); ignored when `upcoming` is true",
"type": [
"string",
"null"
]
},
"to": {
"description": "Latest auction date to include, `YYYY-MM-DD`; ignored when `upcoming` is true",
"type": [
"string",
"null"
]
},
"upcoming": {
"description": "Return the not-yet-held auction schedule instead of auction records",
"type": [
"boolean",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_treasury_yields(cursor, fields, limit, year)
Get US Treasury yield curve data (1m through 30y) for a given year. No API key required.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = all fields",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum rows per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"year": {
"description": "Year to fetch yield curve data for (default: current year)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_trending(fields, region)
Get currently trending stock tickers for a region.
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"region": {
"description": "Region code: US|GB|DE|CA|AU|FR|IN|CN|HK|BR|TW|SG (default: US)",
"type": "string"
}
},
"required": [
"region"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢lookup(fields, lang, logo, query, query_type)
Discover tickers filtered by type (equity, ETF, mutual fund, index, future, currency, cryptocurrency).
Input Schema
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
},
"logo": {
"description": "Include logo URLs (requires an additional upstream API call); default: false",
"type": [
"boolean",
"null"
]
},
"query": {
"description": "Search query (company name or ticker symbol)",
"type": "string"
},
"query_type": {
"description": "Filter by type: equity|etf|mutualfund|index|future|currency|cryptocurrency (default: all)",
"type": "string"
}
},
"required": [
"query",
"query_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢screener(count, fields, screener_type)
Get results from a predefined stock screener (e.g., most-actives, day-gainers, undervalued-growth-stocks).
Input Schema
{
"type": "object",
"properties": {
"count": {
"description": "Number of results to return (default: 25, max: 250)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"screener_type": {
"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",
"type": "string"
}
},
"required": [
"screener_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search(cursor, fields, lang, limit, query)
Search for stocks, ETFs, and companies by name or ticker symbol.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque continuation token from a previous response's `pageInfo.endCursor`; omitted = first page",
"type": [
"string",
"null"
]
},
"fields": {
"description": "Comma-separated list of GraphQL field names to include; omitted = curated default set",
"type": [
"string",
"null"
]
},
"lang": {
"description": "Target language for translated text fields (BCP 47, e.g. \"ja\", \"zh-Hant\"); English or omitted = no translation",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum quotes per page; omitted = curated default (25)",
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"query": {
"description": "Search query string (company name or ticker symbol)",
"type": "string"
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence