QuantApe Markets
Stock screens; per-stock earnings, guidance, signal and sector insights; rotation and market mood.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~11,212Tokens (tool definitions)
~9.5 KBTypical response size
Significant attention impact (8.76% of 128k context)
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": {
"markets": {
"url": "https://mcp.quantape.com/mcp"
}
}
}Remote endpoints
https://mcp.quantape.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢list_smart_lists(category_id)
Browse stock screens by category — momentum, technical signals, fundamentals, earnings events, social sentiment, themes, curated baskets, investment theses — with display names, descriptions, member counts, and the per-tool pricing/allowance for the metered tools below. Always free. Start here to find a screen id.
Input Schema
{
"type": "object",
"properties": {
"category_id": {
"description": "Restrict the catalog to one category id (e.g. momentum, technical, events, thematic); omit for every category.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"description": "Newest rebuild across the returned screens, ISO 8601 UTC",
"type": [
"string",
"null"
]
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"lists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Pass as list_id to the other tools"
},
"display_name": {
"type": "string"
},
"short_description": {
"type": [
"string",
"null"
]
},
"icon": {
"type": [
"string",
"null"
]
},
"member_count": {
"type": [
"number",
"null"
]
},
"updated_at": {
"description": "Screen last rebuilt, ISO 8601 UTC",
"type": [
"string",
"null"
]
},
"parent_list": {
"description": "Id of the screen this one refines",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"display_name",
"short_description",
"icon",
"member_count",
"updated_at",
"parent_list"
],
"additionalProperties": {}
}
}
},
"required": [
"id",
"name",
"description",
"lists"
],
"additionalProperties": {}
}
},
"pricing": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
},
"description": "USD per call of each metered tool beyond the daily allowance"
},
"allowance": {
"type": "object",
"properties": {
"tier": {
"type": "string",
"description": "anon, user or power"
},
"limit": {
"type": "number",
"description": "Free metered calls per 24 hours"
},
"remaining": {
"type": "number"
}
},
"required": [
"tier",
"limit",
"remaining"
],
"additionalProperties": {}
}
},
"required": [
"as_of",
"categories",
"pricing",
"allowance"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_list_criteria(list_id)
Metadata for one stock screen (smart list): display name, short description, icon, category ids and parent screen. Always free.
Input Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string",
"description": "Screen id from list_smart_lists (e.g. day_gainers, todays_earnings)."
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"display_name": {
"type": [
"string",
"null"
]
},
"short_description": {
"type": [
"string",
"null"
]
},
"icon": {
"type": [
"string",
"null"
]
},
"category_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"parent_list": {
"description": "Id of the screen this one refines",
"type": [
"string",
"null"
]
},
"updated_at": {
"description": "Screen last rebuilt, ISO 8601 UTC",
"type": [
"string",
"null"
]
}
},
"required": [
"list_id",
"display_name",
"short_description",
"icon",
"category_ids",
"parent_list",
"updated_at"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_smart_list(list_id, limit, offset)
Symbols currently in a stock screen — e.g. today's earnings, golden-cross buy signals, AI beneficiaries (paged, max 200 per call). Descriptive, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.01 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string",
"description": "Screen id from list_smart_lists (e.g. day_gainers, golden_cross, ai_beneficiaries)."
},
"limit": {
"description": "Symbols per page, 1-200 (default 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Zero-based offset into the screen for paging.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"as_of": {
"description": "Screen last rebuilt, ISO 8601 UTC",
"type": [
"string",
"null"
]
},
"total": {
"type": "number",
"description": "Symbols across all pages."
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"symbols": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"list_id",
"as_of",
"total",
"limit",
"offset",
"symbols"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_smart_list_metrics(list_id, limit, offset)
QuantApe's own per-symbol analytics for a stock screen — last earnings reaction and the drift since it, next earnings date with how much of that report is already priced in (expectations score) and the options-implied move, and recent technical signals (paged, max 200 per call). It returns no live quotes, market cap or valuation ratios; use a quote API for those. Descriptive, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.05 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string",
"description": "Screen id from list_smart_lists (e.g. day_gainers, golden_cross, ai_beneficiaries)."
},
"limit": {
"description": "Symbols per page, 1-200 (default 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Zero-based offset into the screen for paging.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"as_of": {
"description": "Reserved; currently always null",
"type": [
"string",
"null"
]
},
"total": {
"type": "number",
"description": "Symbols across all pages."
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"has_more": {
"type": "boolean"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"companyName": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"earnings_reaction_date": {
"description": "Session of the last earnings reaction, YYYY-MM-DD — the anchor for earnings_reaction_percent and since_earnings_percent",
"type": [
"string",
"null"
]
},
"earnings_reaction_percent": {
"description": "Largest single-session move around the last report, measured on earnings_reaction_date; % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"since_earnings_percent": {
"description": "Close after the last report to the latest stored quote (refreshed on a priority queue, so it can lag a session); % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"next_earnings_date": {
"description": "ISO 8601 UTC — the event expectations_bar_score and implied_move_pct are measured for",
"type": [
"string",
"null"
]
},
"expectations_bar_score": {
"description": "0-100, how much of an earnings move is priced in ahead of next_earnings_date (descriptive, not directional)",
"type": [
"number",
"null"
]
},
"implied_move_pct": {
"description": "Options-implied earnings move for next_earnings_date, 1 sigma; % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"technical_signals": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"description": "Recent signals with their own date each, typically {date, type, name, strength, price}"
}
},
"required": [
"symbol"
],
"additionalProperties": {}
}
}
},
"required": [
"list_id",
"as_of",
"total",
"limit",
"offset",
"has_more",
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_my_watchlist(limit, offset, news_days)
The same per-symbol analytics as get_smart_list_metrics (earnings reaction and drift, expectations score, implied move, technical signals), plus the latest headlines, for your own watchlist — the tool behind "What's going on with my watchlist today?". Requires your session token (Authorization: Bearer). Descriptive, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.05 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Watchlist symbols per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Zero-based offset into the watchlist for paging.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"news_days": {
"description": "How many days of headlines to attach per symbol, 1-7 (default 2).",
"type": "integer",
"minimum": 1,
"maximum": 7
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"description": "Reserved; currently always null",
"type": [
"string",
"null"
]
},
"total": {
"type": "number",
"description": "Symbols across all pages."
},
"limit": {
"type": "number"
},
"offset": {
"type": "number"
},
"has_more": {
"type": "boolean"
},
"news_days": {
"type": "number"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"companyName": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"earnings_reaction_date": {
"description": "Session of the last earnings reaction, YYYY-MM-DD — the anchor for earnings_reaction_percent and since_earnings_percent",
"type": [
"string",
"null"
]
},
"earnings_reaction_percent": {
"description": "Largest single-session move around the last report, measured on earnings_reaction_date; % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"since_earnings_percent": {
"description": "Close after the last report to the latest stored quote (refreshed on a priority queue, so it can lag a session); % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"next_earnings_date": {
"description": "ISO 8601 UTC — the event expectations_bar_score and implied_move_pct are measured for",
"type": [
"string",
"null"
]
},
"expectations_bar_score": {
"description": "0-100, how much of an earnings move is priced in ahead of next_earnings_date (descriptive, not directional)",
"type": [
"number",
"null"
]
},
"implied_move_pct": {
"description": "Options-implied earnings move for next_earnings_date, 1 sigma; % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"technical_signals": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"description": "Recent signals with their own date each, typically {date, type, name, strength, price}"
},
"news": {
"type": "array",
"items": {},
"description": "Up to 3 headlines, typically {title, source, url, publishedAt}"
}
},
"required": [
"symbol",
"news"
],
"additionalProperties": {}
}
},
"news_error": {
"description": "Only when headlines could not be fetched (every row then has news: [])",
"type": "string"
}
},
"required": [
"as_of",
"total",
"limit",
"offset",
"has_more",
"news_days",
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_market_overview(sections)
Today's market conditions: the daily overview narrative, the fear & greed index and per-sector scores, sector rotation and market-cycle phase, and categorized market news. Pick sections to keep the answer small. Pairs with get_my_watchlist for "how is my watchlist doing against the market?". Descriptive, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.02 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"sections": {
"description": "Which sections to return; omit for all five. Pick fewer to keep the answer small.",
"type": "array",
"items": {
"type": "string",
"enum": [
"summary",
"fear_greed",
"sectors",
"rotation",
"news"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"description": "Newest section date, YYYY-MM-DD",
"type": [
"string",
"null"
]
},
"sections": {
"type": "object",
"properties": {
"summary": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"opening": {
"description": "AI-written prose"
},
"key_news": {
"description": "AI-written, typically [{headline, details}]"
},
"sector_highlights": {
"description": "AI-written"
},
"recommendations": {
"description": "AI-written; informational, not advice"
},
"closing": {
"description": "AI-written prose"
}
},
"required": [
"as_of"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"fear_greed": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"score": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"previous_close": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"previous_1_week": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"previous_1_month": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"rating": {
"description": "extreme fear | fear | neutral | greed | extreme greed",
"type": [
"string",
"null"
]
},
"indicators": {
"description": "{<indicator>: {score, rating}}"
}
},
"required": [
"as_of",
"score",
"previous_close",
"previous_1_week",
"previous_1_month",
"rating"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"sectors": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"stale": {
"type": [
"boolean",
"null"
]
},
"sector_average": {
"description": "{score, rating}"
},
"sectors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sector": {
"type": [
"string",
"null"
]
},
"score": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"previous_close": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"previous_1_week": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"previous_1_month": {
"description": "0-100, higher = greedier",
"type": [
"number",
"null"
]
},
"rating": {
"type": [
"string",
"null"
]
}
},
"required": [
"sector",
"score",
"previous_close",
"previous_1_week",
"previous_1_month",
"rating"
],
"additionalProperties": {}
}
}
},
"required": [
"as_of",
"stale",
"sectors"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"rotation": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"market_cycle": {
"description": "{currentPhase, confidence, description}"
},
"sector_analysis": {
"description": "Sectors by leading / improving / weakening / lagging"
},
"rotations": {
"description": "Active and potential rotations"
},
"interpretation": {
"description": "AI-written"
}
},
"required": [
"as_of"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"news": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"stale": {
"description": "True = today's analysis not generated yet; an earlier one is served",
"type": [
"boolean",
"null"
]
},
"summary": {
"description": "AI-written"
},
"categorized": {
"description": "AI-written, by theme"
},
"strategies": {
"description": "AI-written; informational, not advice"
}
},
"required": [
"as_of",
"stale"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
}
},
"additionalProperties": {},
"description": "Only the requested sections are present"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"as_of",
"sections",
"disclaimer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_stock_insights(symbol, sections)
Everything QuantApe derives about ONE stock that a quote API can't tell you — the tool behind "what do you know about NVDA?": last earnings reaction and the drift since, how much of the next report is already priced in (expectations score) and the options-implied move, what the latest earnings call said about guidance, recent technical signals, why it moved today if it was a notable mover, its sector's fear & greed score and rotation quadrant, and which stock screens hold it with how those screens are doing. Each section carries its own as_of. It returns no live quotes, market cap or valuation ratios; use a quote API for those. Pick sections to keep the answer small; inside_sentiment (how the business reads from the inside) is opt-in. Descriptive, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.10 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA or BRK-B."
},
"sections": {
"description": "Which sections to return; omit for the default set (earnings, guidance, signals, movers, sector, screens). Add inside_sentiment explicitly.",
"type": "array",
"items": {
"type": "string",
"enum": [
"earnings",
"guidance",
"signals",
"movers",
"sector",
"screens",
"inside_sentiment"
]
}
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"sector": {
"description": "Derived from industry via the shared industry→sector map",
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"industry",
"sector"
],
"additionalProperties": {}
},
"sections": {
"type": "object",
"properties": {
"earnings": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"description": "Session date of the stored quote since_earnings_percent is measured against, YYYY-MM-DD",
"type": [
"string",
"null"
]
},
"earnings_reaction_date": {
"description": "Session of the last earnings reaction, YYYY-MM-DD — the anchor for earnings_reaction_percent and since_earnings_percent",
"type": [
"string",
"null"
]
},
"earnings_reaction_percent": {
"description": "Largest single-session move around the last report, measured on earnings_reaction_date; % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"since_earnings_percent": {
"description": "Close after the last report to the latest stored quote (refreshed on a priority queue, so it can lag a session); % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"next_earnings_date": {
"description": "ISO 8601 UTC — the event expectations_bar_score and implied_move_pct are measured for",
"type": [
"string",
"null"
]
},
"expectations_bar_score": {
"description": "0-100, how much of an earnings move is priced in ahead of next_earnings_date (descriptive, not directional)",
"type": [
"number",
"null"
]
},
"implied_move_pct": {
"description": "Options-implied earnings move for next_earnings_date, 1 sigma; % points (7.04 = +7.04%)",
"type": [
"number",
"null"
]
},
"last_earnings_date": {
"description": "ISO 8601 UTC",
"type": [
"string",
"null"
]
},
"expectations_bar_rating": {
"description": "Plain-words band of expectations_bar_score",
"type": [
"string",
"null"
]
},
"expectations_bar_coverage": {
"description": "How many of the score's inputs were available",
"type": [
"number",
"null"
]
}
},
"required": [
"as_of",
"earnings_reaction_date",
"earnings_reaction_percent",
"since_earnings_percent",
"next_earnings_date",
"expectations_bar_score",
"implied_move_pct",
"last_earnings_date",
"expectations_bar_rating",
"expectations_bar_coverage"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"guidance": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"description": "Call date of the newest analysed earnings call, ISO 8601 UTC; null = no analysed call on record",
"type": [
"string",
"null"
]
},
"direction": {
"description": "raised | kept | lowered | none | mixed, as the call stated it",
"type": [
"string",
"null"
]
},
"detail": {
"description": "What changed, in the call's own terms; power-user accounts only",
"type": [
"string",
"null"
]
},
"locked": {
"type": "boolean",
"description": "True when a detail exists but the caller's tier cannot see it"
}
},
"required": [
"as_of",
"direction",
"detail",
"locked"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"signals": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"description": "Date of the newest signal, YYYY-MM-DD",
"type": [
"string",
"null"
]
},
"signals": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"description": "Recent signals with their own date each, typically {date, type, name, strength, price}"
}
},
"required": [
"as_of",
"signals"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"movers": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"description": "Trading session the explanation is for, YYYY-MM-DD",
"type": [
"string",
"null"
]
},
"stale": {
"description": "True when that session is not the current UTC day",
"type": [
"boolean",
"null"
]
},
"explanation": {
"anyOf": [
{
"type": "object",
"properties": {
"change_percent": {
"description": "The session move that triggered the search; % points",
"type": [
"number",
"null"
]
},
"summary": {
"description": "Why it moved, in plain words",
"type": [
"string",
"null"
]
},
"no_news": {
"type": "boolean"
},
"sources": {
"description": "Citations, typically [{title, url}]"
}
},
"required": [
"change_percent",
"summary",
"no_news"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "null = the stock was not a notable mover that session"
},
"theme": {
"anyOf": [
{
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"summary": {
"description": "A driver shared with other stocks that session",
"type": [
"string",
"null"
]
},
"sources": {}
},
"required": [
"title",
"summary"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"as_of",
"stale",
"explanation",
"theme"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"sector": {
"anyOf": [
{
"type": "object",
"properties": {
"sector": {
"type": [
"string",
"null"
]
},
"as_of": {
"type": [
"string",
"null"
]
},
"score": {
"description": "0-100 sector fear & greed, higher = greedier",
"type": [
"number",
"null"
]
},
"rating": {
"type": [
"string",
"null"
]
},
"previous_close": {
"type": [
"number",
"null"
]
},
"previous_1_week": {
"type": [
"number",
"null"
]
},
"previous_1_month": {
"type": [
"number",
"null"
]
},
"rotation": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"description": "Newest settled session used, YYYY-MM-DD",
"type": [
"string",
"null"
]
},
"quadrant": {
"description": "leading | weakening | lagging | improving",
"type": [
"string",
"null"
]
},
"relative_strength_pct": {
"description": "20-session return minus the equal-weighted sector average; % points",
"type": [
"number",
"null"
]
},
"momentum_pct": {
"description": "Change in relative strength over the last 5 sessions; % points",
"type": [
"number",
"null"
]
}
},
"required": [
"as_of",
"quadrant",
"relative_strength_pct",
"momentum_pct"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "null when too few settled sessions are stored"
}
},
"required": [
"sector",
"as_of",
"score",
"rating",
"previous_close",
"previous_1_week",
"previous_1_month",
"rotation"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"screens": {
"anyOf": [
{
"type": "object",
"properties": {
"lists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"display_name": {
"type": [
"string",
"null"
]
},
"as_of": {
"description": "Screen last rebuilt, ISO 8601 UTC",
"type": [
"string",
"null"
]
},
"performance": {
"description": "How the screen's current members have done: {avgChange, gainers, losers, stocksWithData, periods}; measures TODAY's members (survivorship)"
}
},
"required": [
"list_id",
"display_name",
"as_of"
],
"additionalProperties": {}
}
}
},
"required": [
"lists"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
},
"inside_sentiment": {
"anyOf": [
{
"type": "object",
"properties": {
"as_of": {
"description": "When the read was last refreshed, ISO 8601 UTC",
"type": [
"string",
"null"
]
},
"sentiment": {
"description": "positive | neutral | negative",
"type": [
"string",
"null"
]
},
"summary": {
"description": "How the business reads from the inside, in plain words",
"type": [
"string",
"null"
]
}
},
"required": [
"as_of",
"sentiment",
"summary"
],
"additionalProperties": {}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"additionalProperties": {}
}
]
}
},
"additionalProperties": {},
"description": "Only the requested sections are present"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"symbol",
"company",
"sections",
"disclaimer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_smart_list_changes(list_id)
Which symbols entered or left a stock screen since its last recorded baseline (which can span several rebuilds) — e.g. new golden crosses, or names that dropped out of the momentum leaders. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.02 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string",
"description": "Screen id from list_smart_lists whose additions and removals you want."
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"as_of": {
"description": "Screen last rebuilt, ISO 8601 UTC",
"type": [
"string",
"null"
]
},
"baseline_as_of": {
"description": "When the baseline was recorded; null = no baseline yet, so added/removed are empty",
"type": [
"string",
"null"
]
},
"added": {
"type": "array",
"items": {
"type": "string"
}
},
"removed": {
"type": "array",
"items": {
"type": "string"
}
},
"added_count": {
"type": "number"
},
"removed_count": {
"type": "number"
}
},
"required": [
"list_id",
"as_of",
"baseline_as_of",
"added",
"removed",
"added_count",
"removed_count"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢find_symbol_lists(symbol)
Every stock screen a given ticker is currently in — its momentum, technical-signal, earnings, theme and thesis memberships, in one call. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.01 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA or BRK-B."
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"lists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"list_id": {
"type": "string"
},
"display_name": {
"type": [
"string",
"null"
]
},
"as_of": {
"description": "Screen last rebuilt, ISO 8601 UTC",
"type": [
"string",
"null"
]
}
},
"required": [
"list_id",
"display_name",
"as_of"
],
"additionalProperties": {}
}
}
},
"required": [
"symbol",
"lists"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢graph_neighbors(symbol, type, window, regime, k)
The stocks that move most with a given ticker, ranked by strength, each with its cluster (a stable id and a label naming its biggest members) — peers, co-movers and offsetting names. Residual correlation is how much two stocks move together after the market and sector effects are removed from each, so it shows peers and true co-movement rather than shared market beta. type=lead_lag instead lists directed lagged relationships (one stock's move followed by another's a few sessions later; direction is from the symbol's point of view), which are weak and largely noise out of sample. Share classes are one company (GOOG is answered as GOOGL). Everything returned is descriptive statistics of past returns, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.01 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. RGTI or BRK-B."
},
"type": {
"description": "resid_corr (default): same-day residual correlation. lead_lag: directed lagged correlation.",
"type": "string",
"enum": [
"resid_corr",
"lead_lag"
]
},
"window": {
"description": "Sessions behind resid_corr: 250 (default) or 60. Leave unset for lead_lag.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"regime": {
"description": "all (default) | highvol | lowvol: volatility regime the correlation was measured in (VIX above / below its trailing median).",
"type": "string",
"enum": [
"all",
"highvol",
"lowvol"
]
},
"k": {
"description": "Neighbours to return, 1-50 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"symbol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"run_date": {
"description": "Date of the nightly run the edges come from, YYYY-MM-DD",
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"window": {
"description": "Sessions behind resid_corr (60 or 250); for lead_lag the sample size",
"type": [
"number",
"null"
]
},
"regime": {
"type": "string"
},
"cluster": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"label"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The symbol's cluster (stable id + label) or null"
},
"peers_kind": {
"description": "'neighbors' when the symbol is in no cluster (cluster_context then returns its closest peers)",
"type": "string",
"enum": [
"cluster",
"neighbors"
]
},
"neighbors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"weight": {
"type": "number",
"description": "Correlation (resid_corr) or lagged correlation (lead_lag), -1 to 1"
},
"n": {
"type": "number",
"description": "Sessions behind the weight"
},
"cluster": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"label"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"lag": {
"description": "lead_lag only: sessions the leader is ahead",
"type": "number"
},
"direction": {
"description": "lead_lag only: leads (the symbol leads the neighbour) | lags | both",
"type": "string"
}
},
"required": [
"symbol",
"weight",
"n",
"cluster"
],
"additionalProperties": {}
}
}
},
"required": [
"symbol",
"run_date",
"type",
"window",
"regime",
"cluster",
"neighbors"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢portfolio_analyze(holdings, regimes, top)
A diversification read on a list of holdings: how concentrated they are across clusters of co-moving stocks (shares, Herfindahl index), the portfolio's residual volatility, which names most and least move with the portfolio as a whole, and which clusters are least correlated to it — per volatility regime (high-vol is the conservative one, since correlations rise when volatility does). Residual correlation is how much two stocks move together after the market and sector effects are removed from each, so it shows peers and true co-movement rather than shared market beta. `diversifiers` are the names with the lowest correlation to the portfolio, not recommendations to buy them. hedge=true marks TLT, GLD and UUP, market ballast rather than residual offsets. Holdings are tickers (equal weight) or {symbol, weight} objects; share classes collapse to one company; tickers outside the graph universe are listed under unknown. Everything returned is descriptive statistics of past returns, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.05 per call via x402 (USDC).
Input Schema
{
"type": "object",
"properties": {
"holdings": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"weight": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"symbol"
]
}
]
},
"description": "1-200 tickers (equal weight) or {symbol, weight} objects (weights positive, given for all holdings or none), e.g. [\"NVDA\",\"XOM\"]."
},
"regimes": {
"description": "Regimes to analyse; default [\"all\",\"highvol\"].",
"type": "array",
"items": {
"type": "string",
"enum": [
"all",
"highvol",
"lowvol"
]
}
},
"top": {
"description": "Diversifiers to list per regime, 1-50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"holdings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"holdings": {
"type": "array",
"items": {
"type": "string"
},
"description": "Canonical symbols analysed (GOOG is GOOGL)"
},
"equal_weight": {
"type": "boolean"
},
"cluster_run_date": {
"type": [
"string",
"null"
]
},
"regimes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"regime": {
"type": "string"
},
"run_date": {
"type": [
"string",
"null"
]
},
"window": {
"type": [
"number",
"null"
]
},
"used": {
"type": "array",
"items": {
"type": "string"
}
},
"unknown": {
"type": "array",
"items": {
"type": "string"
},
"description": "Holdings not in the graph universe"
},
"concentration": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cluster": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"label"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"holdings": {
"type": "array",
"items": {
"type": "string"
}
},
"share": {
"type": "number"
}
},
"required": [
"cluster",
"holdings",
"share"
],
"additionalProperties": {}
}
},
"herfindahl": {
"description": "1 = everything in one cluster; each unclustered holding counts as its own group",
"type": [
"number",
"null"
]
},
"residual_sd": {
"description": "Portfolio daily residual standard deviation, as a fraction (0.014 = 1.4%)",
"type": [
"number",
"null"
]
},
"diversifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"cluster": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"label"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"corr": {
"type": [
"number",
"null"
]
},
"hedge": {
"type": "boolean"
}
},
"required": [
"symbol",
"cluster",
"corr",
"hedge"
],
"additionalProperties": {}
}
},
"most_correlated": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"cluster": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"label"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"corr": {
"type": [
"number",
"null"
]
},
"hedge": {
"type": "boolean"
}
},
"required": [
"symbol",
"cluster",
"corr",
"hedge"
],
"additionalProperties": {}
}
},
"cluster_exposure": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cluster": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"label"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"mean_corr": {
"type": [
"number",
"null"
]
}
},
"required": [
"cluster",
"mean_corr"
],
"additionalProperties": {}
}
}
},
"required": [
"regime",
"run_date",
"window",
"used",
"unknown",
"concentration",
"herfindahl",
"residual_sd",
"diversifiers",
"most_correlated",
"cluster_exposure"
],
"additionalProperties": {}
}
},
"unavailable": {
"type": "array",
"items": {
"type": "string"
},
"description": "Requested regimes without a matrix yet"
}
},
"required": [
"holdings",
"equal_weight",
"cluster_run_date",
"regimes",
"unavailable"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢cluster_context(symbol, cluster_id, days, mode, include_digest)
What happened recently to a ticker's peers: the cluster's move over the last 5 or 20 days (raw, market and residual), plus the news, earnings reactions, earnings-call guidance, price-mover explanations and themes that name its members. Give a symbol (its cluster; share classes are one company) or a cluster_id from graph_neighbors. Mega-caps and other names without a tight cluster get their closest residual-correlation peers instead (peers.kind = 'neighbors'). Peers are the ticker's residual-correlation cluster: stocks that move together once the market is removed. move is the cluster's equal-weight average in percent over the last 5 or 20 sessions: raw_* is the plain price move, market_* is SPY's, and residual_* is the move left after removing the market (the cluster-specific part); move.members has each member's own figures. Every news, earnings, transcript, mover and theme item cites a member symbol and a date. The optional digest (include_digest) is an LLM summary constrained to the cluster's members, each bullet citing members and a date; it may add latency, not cost. With mode 'peers' (symbol input only) the peers are instead the stocks whose residual moves track the ticker most closely (positive residual correlation over the past year, listed in peers.corr, with the ticker's leaf cluster as peers.theme): move is then the peers-only mean, move.symbol the ticker's own move and move.divergence_5d / _20d the ticker minus its peers, in percentage points. All of it is descriptive, not a recommendation. Free within your daily allowance (anonymous 5/day by IP, signed-in users 10/day, power users 50/day); beyond that $0.03 per call via x402 (USDC), with or without the digest.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"description": "Ticker symbol, e.g. RGTI. Give this or cluster_id, not both.",
"type": "string"
},
"cluster_id": {
"description": "Cluster id from graph_neighbors. Give this or symbol, not both.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"days": {
"description": "Look-back window in days: 5 (default) or 20.",
"type": "number",
"enum": [
5,
20
]
},
"mode": {
"description": "Symbol input only. 'cluster' (default): the ticker's residual-correlation cluster. 'peers': the ticker plus the stocks whose residual moves track it most closely (with peers.corr), the peers' mean move, the ticker's own move and its divergence from them.",
"type": "string",
"enum": [
"cluster",
"peers"
]
},
"include_digest": {
"description": "Also attach the LLM digest (default false). Slower; a failed digest comes back as digest: null with digest_status, never as an error.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"symbol": {
"description": "The ticker asked about (symbol input only)",
"type": "string"
},
"cluster": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
},
"members": {
"type": "array",
"items": {
"type": "string"
}
},
"run_date": {
"description": "Date of the nightly clustering run",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"label",
"members",
"run_date"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The symbol's cluster, or null when it is in no tight cluster (then see peers)"
},
"peers": {
"description": "symbol input only: the peers the payload covers (absent for cluster_id input)",
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"cluster",
"industry",
"neighbors",
"peers"
],
"description": "'peers' (mode peers): the symbol plus the stocks whose residual moves track it most closely, r >= min_corr, ranked in peers.corr; 'cluster': the symbol's peer group (a leaf of the cluster hierarchy); 'industry': no tight cluster, so its industry peers ranked by residual correlation; 'neighbors': the symbol plus its closest residual-correlation peers (industry unknown)"
},
"id": {
"description": "Cluster id when kind is cluster, else null",
"type": [
"number",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"members": {
"type": "array",
"items": {
"type": "string"
},
"description": "The symbols that move, news and the other lists are computed over; includes the asked symbol"
},
"run_date": {
"description": "Date of the nightly run behind the peers",
"type": [
"string",
"null"
]
},
"min_weight": {
"description": "industry and neighbors only: the minimum residual correlation of a peer",
"type": "number"
},
"min_corr": {
"description": "peers only: the minimum residual correlation of a peer",
"type": "number"
},
"corr": {
"description": "peers only: peer ticker -> its residual correlation with the asked symbol over 250 sessions (market removed), most correlated first",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"theme": {
"description": "peers only: the symbol's leaf cluster, for context, or null when it is in none",
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
},
"size": {
"type": "number"
}
},
"required": [
"id",
"label",
"size"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"note": {
"type": [
"string",
"null"
]
},
"parent": {
"description": "cluster only: the larger theme this peer group was split from, or null",
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "number"
},
"label": {
"type": [
"string",
"null"
]
},
"size": {
"type": "number"
}
},
"required": [
"id",
"label",
"size"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"industry": {
"description": "cluster: the group's dominant industry; industry: the industry the peers belong to",
"type": [
"string",
"null"
]
},
"depth": {
"description": "cluster only: 0 = a top-level theme, 1+ = a peer group split from one",
"type": [
"number",
"null"
]
},
"scope": {
"description": "symbol input only: which members share the symbol's own industry ('industry'), its sector ('sector'), or none ('cluster': the whole group stands in)",
"type": "string",
"enum": [
"industry",
"sector",
"cluster"
]
},
"industry_members": {
"description": "symbol input only: the members in scope, the asked symbol first (the group the scoped move is about)",
"type": "array",
"items": {
"type": "string"
}
},
"other_members": {
"description": "symbol input only: the rest of members (empty when scope is cluster)",
"type": "array",
"items": {
"type": "string"
}
},
"symbol_industry": {
"description": "The asked symbol's industry",
"type": [
"string",
"null"
]
},
"sector": {
"description": "The asked symbol's sector",
"type": [
"string",
"null"
]
}
},
"required": [
"kind",
"id",
"label",
"members",
"run_date"
],
"additionalProperties": {}
},
"days": {
"type": "number",
"description": "5 or 20 calendar days behind news, earnings, transcripts, movers and themes"
},
"as_of": {
"description": "YYYY-MM-DD the window ends on",
"type": [
"string",
"null"
]
},
"move": {
"type": "object",
"properties": {
"residual_5d": {
"description": "Cluster mean move in percent after removing the market, last 5 sessions",
"type": [
"number",
"null"
]
},
"residual_20d": {
"type": [
"number",
"null"
]
},
"raw_5d": {
"description": "Cluster mean plain price move in percent",
"type": [
"number",
"null"
]
},
"raw_20d": {
"type": [
"number",
"null"
]
},
"market_5d": {
"description": "SPY move in percent",
"type": [
"number",
"null"
]
},
"market_20d": {
"type": [
"number",
"null"
]
},
"dispersion_5d": {
"description": "Sample standard deviation, in percent, of the members' residual moves: how spread out the group was",
"type": [
"number",
"null"
]
},
"dispersion_20d": {
"type": [
"number",
"null"
]
},
"symbol": {
"description": "peers mode only: the asked symbol's own move (the group figures above exclude it)",
"type": "object",
"properties": {
"residual_5d": {
"type": [
"number",
"null"
]
},
"residual_20d": {
"type": [
"number",
"null"
]
},
"raw_5d": {
"type": [
"number",
"null"
]
},
"raw_20d": {
"type": [
"number",
"null"
]
}
},
"required": [
"residual_5d",
"residual_20d",
"raw_5d",
"raw_20d"
],
"additionalProperties": {}
},
"divergence_5d": {
"description": "peers mode only: the symbol's residual move minus the peers' mean, in percentage points",
"type": [
"number",
"null"
]
},
"divergence_20d": {
"type": [
"number",
"null"
]
},
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"corr": {
"description": "peers mode only: residual correlation with the asked symbol",
"type": [
"number",
"null"
]
},
"residual_5d": {
"type": [
"number",
"null"
]
},
"residual_20d": {
"type": [
"number",
"null"
]
},
"raw_5d": {
"type": [
"number",
"null"
]
},
"raw_20d": {
"type": [
"number",
"null"
]
},
"z_5d": {
"description": "Standard deviations from the group's mean residual move (null with fewer than 3 members or no spread)",
"type": [
"number",
"null"
]
},
"z_20d": {
"type": [
"number",
"null"
]
}
},
"required": [
"symbol",
"residual_5d",
"residual_20d",
"raw_5d",
"raw_20d"
],
"additionalProperties": {}
}
},
"scoped": {
"description": "symbol input only: the same figures over industry_members only (the symbol and the peers that share its industry or sector)",
"type": "object",
"properties": {
"residual_5d": {
"type": [
"number",
"null"
]
},
"residual_20d": {
"type": [
"number",
"null"
]
},
"raw_5d": {
"type": [
"number",
"null"
]
},
"raw_20d": {
"type": [
"number",
"null"
]
},
"dispersion_5d": {
"type": [
"number",
"null"
]
},
"dispersion_20d": {
"type": [
"number",
"null"
]
},
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"z_5d": {
"type": [
"number",
"null"
]
},
"z_20d": {
"type": [
"number",
"null"
]
}
},
"required": [
"symbol"
],
"additionalProperties": {}
}
}
},
"required": [
"residual_5d",
"residual_20d",
"raw_5d",
"raw_20d"
],
"additionalProperties": {}
}
},
"required": [
"residual_5d",
"residual_20d",
"raw_5d",
"raw_20d",
"market_5d",
"market_20d",
"members"
],
"additionalProperties": {}
},
"news": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbols": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"published_at": {
"type": "string"
}
},
"required": [
"symbols",
"title",
"source",
"url",
"published_at"
],
"additionalProperties": {}
}
},
"earnings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"earnings_date": {
"type": "string"
},
"move_pct": {
"description": "Percent move around the report",
"type": [
"number",
"null"
]
}
},
"required": [
"symbol",
"earnings_date",
"move_pct"
],
"additionalProperties": {}
}
},
"transcripts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"call_date": {
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
},
"guidance_direction": {
"type": [
"string",
"null"
]
},
"guidance_detail": {
"type": [
"string",
"null"
]
},
"narrative": {
"type": [
"string",
"null"
]
}
},
"required": [
"symbol",
"call_date",
"title",
"guidance_direction",
"guidance_detail",
"narrative"
],
"additionalProperties": {}
}
},
"movers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"session_date": {
"type": "string"
},
"change_percent": {
"type": [
"number",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
}
},
"required": [
"symbol",
"session_date",
"change_percent",
"summary"
],
"additionalProperties": {}
}
},
"themes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"session_date": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
},
"symbols": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"session_date",
"title",
"summary",
"symbols"
],
"additionalProperties": {}
}
},
"counts": {
"type": "object",
"properties": {
"news": {
"type": "number"
},
"earnings": {
"type": "number"
},
"transcripts": {
"type": "number"
},
"movers": {
"type": "number"
},
"themes": {
"type": "number"
}
},
"required": [
"news",
"earnings",
"transcripts",
"movers",
"themes"
],
"additionalProperties": {}
},
"digest": {
"description": "include_digest only: LLM summary constrained to the member symbols of the peers; null when it could not be produced",
"anyOf": [
{
"type": "object",
"properties": {
"headline": {
"type": "string"
},
"bullets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"symbols": {
"type": "array",
"items": {
"type": "string"
}
},
"date": {
"type": "string"
}
},
"required": [
"text",
"symbols",
"date"
],
"additionalProperties": {}
}
},
"watch": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"symbols": {
"type": "array",
"items": {
"type": "string"
}
},
"date": {
"type": "string"
}
},
"required": [
"text",
"symbols",
"date"
],
"additionalProperties": {}
}
}
},
"required": [
"headline",
"bullets",
"watch"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"digest_status": {
"description": "include_digest only",
"type": "string",
"enum": [
"ok",
"rejected",
"unavailable",
"error"
]
},
"digest_model": {
"description": "include_digest only",
"type": [
"string",
"null"
]
}
},
"required": [
"cluster",
"days",
"as_of",
"move",
"news",
"earnings",
"transcripts",
"movers",
"themes",
"counts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}Community
Evidence
Recent observations
verifiedversion not recorded12 tools
verifiedversion not recorded12 tools
verifiedversion not recorded12 tools
verifiedversion not recorded12 tools
verifiedversion not recorded9 tools
verifiedversion not recorded8 tools