--- 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, required - `pcr` Pcr, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `quote_date` string, required — Quote as-of date (YYYY-MM-DD). - `pcr_notional` number, required — Put/call ratio by notional value. - `underlying_symbol` string, required — Underlying security symbol. - `date` string, required — Observation date (YYYY-MM-DD). - `ticker` string, required — Security ticker symbol. - `key_takeaways` KeyTakeaways, required - `tldr` string, required — Short summary (one-line TLDR). - `teaser` string, required — Short teaser summary. - `timeframe_insights` TimeframeInsights, required - `one_week` string, required — One-week narrative insight. - `one_year` string, required — One-year narrative insight. - `one_month` string, required — One-month narrative insight. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — Last-update timestamp (ISO 8601). - `debug` object, required — Debug information. - `options_data` OptionsData, required - `2026-02-08` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-02-06` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-02-05` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-02-04` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-02-03` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-02-02` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-02-01` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-30` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-29` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-28` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-27` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-26` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-25` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-23` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-22` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-21` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-20` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `2026-01-16` DailyPutCallRatio, required - `pcr_volume` number, required — Put/call ratio by trading volume. - `pcr_notional` number, required — Put/call ratio by notional value. - `options_window_data` object, required — Options-window data payload. - `news_summary` NewsSummary, required - `debug` object, required — Debug information. - `limit` integer, required — Maximum number of results. - `min_score` number, required — Minimum score threshold applied. - `news_summary` NewsSummary1, required - `id` string, required — Record identifier. - `tldr` string, required — Short summary (one-line TLDR). - `themes` Theme[], required — Array of themes. - `theme_name` string, required — Theme name. - `theme_description` string, required — Theme description. - `summary` string, required — Summary text. - `key_events` string[], required — Array of key events. - `dynamic_sections` DynamicSection[], required — Array of dynamic analysis sections. - `section_title` string, required — Section title. - `section_content` string, required — Section content. - `articles_info` ArticlesInfoItem[], required — Array of article metadata. - `title` string, required — Display title. - `yahoo_url` string, required — Article source URL. Wire field name is historical. - `article_id` string, required — Article identifier. - `provider_url` string, required — Content-provider URL. - `provider_name` string, required — Content-provider name. - `thumbnail_url` string, required — Thumbnail image URL. - `published_date` string, required — Publication date. - `generation_start_time` string, required — Generation start timestamp. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — Last-update timestamp (ISO 8601). - `holdings_insights` HoldingsInsights, required - `debug` object, required — Debug information. - `insiderActivity` InsiderActivity, required - `highlights` string, required — Key highlights text. - `key_takeaways` string, required — Key takeaways text. - `analysis_update_time` string, required — Analysis update timestamp. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — Last-update timestamp (ISO 8601). - `overview` Overview, required - `ticker` string, required — Security ticker symbol. - `overview` Overview1, required - `tldr` string, required — Short summary (one-line TLDR). - `key_observations` KeyObservations, required - `Analyst Sentiment` string, required — Analyst sentiment summary. - `Valuation Metrics` string, required — Valuation Metrics insight. - `MacBook Neo Success` string, required — MacBook Neo Success insight. - `Insider Transactions` string, required — Insider Transactions insight. - `Strong iPhone Demand` string, required — Strong iPhone Demand insight. - `analysis_update_time` string, required — Analysis update timestamp. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — Last-update timestamp (ISO 8601). - `debug` object, required — Debug information. - `rtr` Rtr, required - `debug` object, required — Debug information. - `rtr_summary` RtrSummary, required - `id` string, required — Record identifier. - `tldr` string, required — Short summary (one-line TLDR). - `viewpoint` string, required — Analyst viewpoint. - `price_target` string, required — Analyst price target. - `ratings_summary` string, required — Ratings summary. - `recent_upgrades` string, required — Recent upgrades summary. - `viewpoint_details` string, required — Viewpoint details. - `generation_start_time` string, required — Generation start timestamp. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — Last-update timestamp (ISO 8601). - `financial_insights` FinancialInsights, required - `tldr` string, required — Short summary (one-line TLDR). - `debug` object, required — Debug information. - `categories` QuotesCategories, required - `Valuation` string, required — Valuation block. - `Profitability` string, required — Profitability summary. - `Growth Metrics` string, required — Growth Metrics insight. - `earnings_calendar` EarningsCalendarItem[], required — Earnings calendar items. - `fiscal_year` integer, required — Fiscal year. - `fiscal_period` string, required — Fiscal period (Q1, Q2, Q3, Q4, FY). - `earnings_release` string, required — Earnings release date. - `latest_earnings_metadata` LatestEarningsMetadata, required - `fiscal_year` integer, required — Fiscal year. - `fiscal_period` string, required — Fiscal period (Q1, Q2, Q3, Q4, FY). - `period_end_date` string, required — Period end date. - `period_start_date` string, required — Period start date. - `earnings_disclosed_at` string, required — Earnings disclosure timestamp. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — Last-update timestamp (ISO 8601). - `earnings_transcripts_insights` EarningsTranscriptsInsights, required - `earnings_analysis` EarningsAnalysis, required - `tldr` string, required — Short summary (one-line TLDR). - `teaser_tldr` string, required — Short teaser TLDR. - `key_insights` KeyInsights, required - `Outlook` string, required — Outlook summary. - `Segment Insights` string, required — Segment Insights insight. - `Narrative Summary` string, required — Narrative Summary insight. - `Strategic Updates` string, required — Strategic Updates insight. - `Risks & Challenges` string, required — Risks & Challenges insight. - `Operational Metrics` string, required — Operational Metrics insight. - `Management Confidence` string, required — Management Confidence insight. - `Market & Macro Context` string, required — Market & Macro Context insight. - `Performance Highlights` string, required — Performance Highlights insight. - `Competitive Positioning` string, required — Competitive Positioning insight. - `Strengths & Opportunities` string, required — Strengths & Opportunities insight. - `Quarter-over-Quarter Changes` string, required — Quarter-over-Quarter Changes insight. - `analyst_focus` AnalystFocus, required - `overall_sentiment` string, required — Overall sentiment. - `key_questions_and_responses` KeyQuestionsAndResponse[], required — Array of key questions and responses. - `question` string, required — Question text (for prediction markets). - `response` string, required — Response text. - `significance` string, required — Significance classifier. - `qa_highlights` QaHighlights, required - `key_themes` string, required — Key themes. - `management_tone` string, required — Management tone. - `analyst_sentiment` string, required — Analyst sentiment summary. - `notable_exchanges` string, required — Notable question-answer exchanges. - `notable_quotes` NotableQuote[], required — Array of notable quotes. - `quote` string, required — Direct quote text. - `context` string, required — Context in which the quote was made. - `speaker` string, required — Speaker or author identifier. - `next_earnings_date` string, required — Next earnings date. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — Last-update timestamp (ISO 8601). - `fiscal_year` string, required — Fiscal year. - `fiscal_period` string, required — Fiscal period (Q1, Q2, Q3, Q4, FY). - `debug` object, required — Debug information. - `price_movement` PriceMovement, required - `data` QuotesData, required - `beta` number, required — Beta coefficient (volatility vs market). - `sector` string, required — GICS sector. - `industry` string, required — GICS industry. - `stock_ticker` string, required — Stock ticker symbol. - `recent_news_articles` RecentNewsArticle[], required — Array of recent news articles. - `title` string, required — Display title. - `summary` string, required — Summary text. - `yahoo_url` string, required — Article source URL. Wire field name is historical. - `article_id` string, required — Article identifier. - `provider_url` string, required — Content-provider URL. - `provider_name` string, required — Content-provider name. - `thumbnail_url` string, required — Thumbnail image URL. - `published_date` string, required — Publication date. - `market_benchmark_ticker` string, required — Market benchmark ticker. - `sector_benchmark_ticker` string, required — Sector benchmark ticker. - `SPX_percentage_price_change` number, required — S&P 500 percent price change. - `recent_insider_transactions` unknown, required - `stock_percentage_price_change` number, required — Stock percent price change. - `sector_percentage_price_change` number, required — Sector percent price change. - `recent_analyst_upgrades_summary` unknown, required - `debug` object, required — Debug information. - `query` string, required — Search query that produced these results. - `ticker` string, required — Security ticker symbol. - `explanation` Explanation, required - `tldr` string, required — Short summary (one-line TLDR). - `bottom_line` string, required — Bottom-line takeaway. - `observations` Observations, required - `Market context` string, required — Market context insight. - `Earnings anticipation impact` string, required — Earnings anticipation impact insight. - `show_insight` boolean, required — Flag: show the insight. - `trace_id` string, required — Request trace identifier. - `created_at` string, required — Creation timestamp (ISO 8601). - `updated_at` string, required — 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. - `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. --- [API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/4e2740743eb4/schema)