--- title: "Market analytics data" method: GET path: "/api/v2/quotes/{symbol}/analyst" tags: ["Finance"] --- # Market analytics data `GET /api/v2/quotes/{symbol}/analyst` Analyst consensus, price target distribution, estimate revisions. ## Path parameters - `symbol` string, required — Security ticker symbol. ## Response `200` Analyst consensus and estimates. - EnvelopeQuotesSymbolAnalystData - `data` QuotesSymbolAnalystData, required - `options_analysis` OptionsAnalysis - `pcr` Pcr - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `quote_date` string, nullable — Quote as-of date (YYYY-MM-DD). - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `underlying_symbol` string, nullable — Underlying security symbol. - `date` string, nullable — Observation date (YYYY-MM-DD). - `ticker` string, nullable — Security ticker symbol. - `key_takeaways` KeyTakeaways - `tldr` string, nullable — Short summary (one-line TLDR). - `teaser` string, nullable — Short teaser summary. - `timeframe_insights` TimeframeInsights - `one_week` string, nullable — One-week narrative insight. - `one_year` string, nullable — One-year narrative insight. - `one_month` string, nullable — One-month narrative insight. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `debug` object, nullable — Debug information. - `options_data` OptionsData - `2026-02-08` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-02-06` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-02-05` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-02-04` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-02-03` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-02-02` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-02-01` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-30` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-29` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-28` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-27` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-26` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-25` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-23` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-22` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-21` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-20` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `2026-01-16` DailyPutCallRatio - `pcr_volume` union — Put/call ratio by trading volume. - integer - number - `pcr_notional` union — Put/call ratio by notional value. - integer - number - `options_window_data` object, nullable — Options-window data payload. - `news_summary` NewsSummary - `debug` object, nullable — Debug information. - `limit` union — Maximum number of results. - integer - number - `min_score` union — Minimum score threshold applied. - integer - number - `news_summary` NewsSummary1 - `id` string, nullable — Record identifier. - `tldr` string, nullable — Short summary (one-line TLDR). - `themes` Theme[], nullable — Array of themes. - `theme_name` string, nullable — Theme name. - `theme_description` string, nullable — Theme description. - `summary` string, nullable — Summary text. - `key_events` string[], nullable — Array of key events. - `dynamic_sections` DynamicSection[], nullable — Array of dynamic analysis sections. - `section_title` string, nullable — Section title. - `section_content` string, nullable — Section content. - `articles_info` ArticlesInfoItem[], nullable — Array of article metadata. - `title` string, nullable — Display title. - `yahoo_url` string, nullable — Article source URL. Wire field name is historical. - `article_id` string, nullable — Article identifier. - `provider_url` string, nullable — Content-provider URL. - `provider_name` string, nullable — Content-provider name. - `thumbnail_url` string, nullable — Thumbnail image URL. - `published_date` string, nullable — Publication date. - `generation_start_time` string, nullable — Generation start timestamp. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `holdings_insights` HoldingsInsights - `debug` object, nullable — Debug information. - `insiderActivity` InsiderActivity - `highlights` string, nullable — Key highlights text. - `key_takeaways` string, nullable — Key takeaways text. - `analysis_update_time` string, nullable — Analysis update timestamp. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `overview` Overview - `ticker` string, nullable — Security ticker symbol. - `overview` Overview1 - `tldr` string, nullable — Short summary (one-line TLDR). - `key_observations` KeyObservations - `Analyst Sentiment` string, nullable — Analyst sentiment summary. - `Valuation Metrics` string, nullable — Valuation Metrics insight. - `MacBook Neo Success` string, nullable — MacBook Neo Success insight. - `Insider Transactions` string, nullable — Insider Transactions insight. - `Strong iPhone Demand` string, nullable — Strong iPhone Demand insight. - `analysis_update_time` string, nullable — Analysis update timestamp. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `debug` object, nullable — Debug information. - `rtr` Rtr - `debug` object, nullable — Debug information. - `rtr_summary` RtrSummary - `id` string, nullable — Record identifier. - `tldr` string, nullable — Short summary (one-line TLDR). - `viewpoint` string, nullable — Analyst viewpoint. - `price_target` string, nullable — Analyst price target. - `ratings_summary` string, nullable — Ratings summary. - `recent_upgrades` string, nullable — Recent upgrades summary. - `viewpoint_details` string, nullable — Viewpoint details. - `generation_start_time` string, nullable — Generation start timestamp. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `financial_insights` FinancialInsights - `tldr` string, nullable — Short summary (one-line TLDR). - `debug` object, nullable — Debug information. - `categories` QuotesCategories - `Valuation` string, nullable — Valuation block. - `Profitability` string, nullable — Profitability summary. - `Growth Metrics` string, nullable — Growth Metrics insight. - `earnings_calendar` EarningsCalendarItem[], nullable — Earnings calendar items. - `fiscal_year` union — Fiscal year. - integer - number - `fiscal_period` string, nullable — Fiscal period (Q1, Q2, Q3, Q4, FY). - `earnings_release` string, nullable — Earnings release date. - `latest_earnings_metadata` LatestEarningsMetadata - `fiscal_year` union — Fiscal year. - integer - number - `fiscal_period` string, nullable — Fiscal period (Q1, Q2, Q3, Q4, FY). - `period_end_date` string, nullable — Period end date. - `period_start_date` string, nullable — Period start date. - `earnings_disclosed_at` string, nullable — Earnings disclosure timestamp. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `earnings_transcripts_insights` EarningsTranscriptsInsights - `earnings_analysis` EarningsAnalysis - `tldr` string, nullable — Short summary (one-line TLDR). - `teaser_tldr` string, nullable — Short teaser TLDR. - `key_insights` KeyInsights - `Outlook` string, nullable — Outlook summary. - `Segment Insights` string, nullable — Segment Insights insight. - `Narrative Summary` string, nullable — Narrative Summary insight. - `Strategic Updates` string, nullable — Strategic Updates insight. - `Risks & Challenges` string, nullable — Risks & Challenges insight. - `Operational Metrics` string, nullable — Operational Metrics insight. - `Management Confidence` string, nullable — Management Confidence insight. - `Market & Macro Context` string, nullable — Market & Macro Context insight. - `Performance Highlights` string, nullable — Performance Highlights insight. - `Competitive Positioning` string, nullable — Competitive Positioning insight. - `Strengths & Opportunities` string, nullable — Strengths & Opportunities insight. - `Quarter-over-Quarter Changes` string, nullable — Quarter-over-Quarter Changes insight. - `analyst_focus` AnalystFocus - `overall_sentiment` string, nullable — Overall sentiment. - `key_questions_and_responses` KeyQuestionsAndResponse[], nullable — Array of key questions and responses. - `question` string, nullable — Question text (for prediction markets). - `response` string, nullable — Response text. - `significance` string, nullable — Significance classifier. - `qa_highlights` QaHighlights - `key_themes` string, nullable — Key themes. - `management_tone` string, nullable — Management tone. - `analyst_sentiment` string, nullable — Analyst sentiment summary. - `notable_exchanges` string, nullable — Notable question-answer exchanges. - `notable_quotes` NotableQuote[], nullable — Array of notable quotes. - `quote` string, nullable — Direct quote text. - `context` string, nullable — Context in which the quote was made. - `speaker` string, nullable — Speaker or author identifier. - `next_earnings_date` string, nullable — Next earnings date. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `fiscal_year` string, nullable — Fiscal year. - `fiscal_period` string, nullable — Fiscal period (Q1, Q2, Q3, Q4, FY). - `debug` object, nullable — Debug information. - `price_movement` PriceMovement - `data` QuotesData - `beta` union — Beta coefficient (volatility vs market). - integer - number - `sector` string, nullable — GICS sector. - `industry` string, nullable — GICS industry. - `stock_ticker` string, nullable — Stock ticker symbol. - `recent_news_articles` RecentNewsArticle[], nullable — Array of recent news articles. - `title` string, nullable — Display title. - `summary` string, nullable — Summary text. - `yahoo_url` string, nullable — Article source URL. Wire field name is historical. - `article_id` string, nullable — Article identifier. - `provider_url` string, nullable — Content-provider URL. - `provider_name` string, nullable — Content-provider name. - `thumbnail_url` string, nullable — Thumbnail image URL. - `published_date` string, nullable — Publication date. - `market_benchmark_ticker` string, nullable — Market benchmark ticker. - `sector_benchmark_ticker` string, nullable — Sector benchmark ticker. - `SPX_percentage_price_change` union — S&P 500 percent price change. - integer - number - `recent_insider_transactions` unknown - `stock_percentage_price_change` union — Stock percent price change. - integer - number - `sector_percentage_price_change` union — Sector percent price change. - integer - number - `recent_analyst_upgrades_summary` unknown - `debug` object, nullable — Debug information. - `query` string, nullable — Search query that produced these results. - `ticker` string, nullable — Security ticker symbol. - `explanation` Explanation - `tldr` string, nullable — Short summary (one-line TLDR). - `bottom_line` string, nullable — Bottom-line takeaway. - `observations` Observations - `Market context` string, nullable — Market context insight. - `Earnings anticipation impact` string, nullable — Earnings anticipation impact insight. - `show_insight` boolean, nullable — Flag: show the insight. - `trace_id` string, nullable — Request trace identifier. - `created_at` string, nullable — Creation timestamp (ISO 8601). - `updated_at` string, nullable — Last-update timestamp (ISO 8601). - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope. - `endpoint` string, required — Requested endpoint path. - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request. - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced. - `provider` string, required — API name and version. - `source` string, nullable — Identifier of the primary upstream source used for this response. - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response. - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data. - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried. - `cached` boolean, nullable — True when this response was served from the internal cache. - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data. ## Other responses - `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401. - `422` — Validation Error - `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window. - `503` — Upstream source is temporarily unavailable. Retry after a short delay. ## Changes - **2026-08-28** `560e8847c7b3` — 78 breaking, 8 info - the response property `data/earnings_transcripts_insights` became optional for the status `200` - the response property `data/financial_insights` became optional for the status `200` - the response property `data/holdings_insights` became optional for the status `200` - the response property `data/news_summary` became optional for the status `200` - …82 more - **2026-08-08** `4c4530760ba1` — 12 info - added the optional property `code` to the response with the `401` status - added the optional property `code` to the response with the `429` status - added the optional property `code` to the response with the `503` status - added the optional property `hint` to the response with the `401` status - …8 more [Change history](https://skmtc.dev/sugra/apis/sugra-api/changes/api/v2/quotes/:symbol/analyst/get.md) --- [API](https://skmtc.dev/sugra/apis/sugra-api.md) · [All operations](https://skmtc.dev/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sugra/sugra-api/revisions/87582f2e0110/schema)