{"uid":"cap_CrNQFStaemqSh8bGFX_ID","slug":"krx-analyst-consensus-api-fb2b30bf","name":"KRX Analyst Consensus API","description":"Analyst consensus for one KRX ticker, built from the archived research history: mean/median/min/max target price across brokerages, the spread between them, the rating distribution, and a revision log of every target-price and rating change each house has made. Consensus uses each house's latest view, so a weekly publisher does not outvote a quarterly one. Params: ?window=30d|90d|180d|365d (default 90d).","url":"https://k-data-x402-production.theblack1022.workers.dev/api/research/consensus/:ticker","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"6-digit KRX code, e.g. 005930"}}},"queryParams":{"type":"object","properties":{"window":{"enum":["30d","90d","180d","365d"],"type":"string","description":"Lookback window (default 90d)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.12","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.12/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MzXucZqg0A8Ua5PPWJD9w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.12","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated analyst consensus data for a single KRX-listed stock, including mean/median/min/max target prices, spread, rating distribution, and revision history across brokerages over a configurable lookback window.","exampleAgentPrompt":"What's the current analyst consensus for Samsung Electronics (KRX: 005930) — give me the mean and median target price, the rating breakdown, and any target price revisions from the last 90 days.","exampleUseCases":[{"title":"Pre-investment analyst sentiment check","prompt":"Before I consider buying Kakao Corp (KRX: 035720), can you pull the analyst consensus for the last 180 days — I want to see the average target price, how bullish or bearish the ratings are, and whether any brokerages have revised their targets recently?"},{"title":"Tracking target price drift over time","prompt":"Has the analyst consensus target price for SK Hynix (KRX: 000660) shifted meaningfully in the past year? Show me the revision log so I can see how individual brokerages have changed their views over the 365-day window."},{"title":"Comparing bull-bear spread for a volatile stock","prompt":"How wide is the gap between the most optimistic and most pessimistic analyst targets for LG Energy Solution (KRX: 373220) right now? Give me the 30-day consensus with min, max, and the spread."}],"resultDescription":"A JSON object containing the analyst consensus for the requested KRX ticker over the specified window, including: mean, median, min, and max target prices across brokerages; the spread between extremes; a rating distribution (e.g., buy/hold/sell counts and percentages); and a chronological revision log of every target-price and rating change made by each brokerage — using each house's most recent view to prevent frequency bias.","failureModes":["Invalid or non-existent KRX ticker returns a 404 or error payload","No analyst coverage found for the ticker in the requested window returns an empty consensus","Invalid window parameter value returns a validation error","Payment not completed (x402) results in a 402 Payment Required response","Upstream research archive unavailable causes a 503 or timeout","Ticker passed in wrong format (e.g., non-6-digit code) may return a validation error"],"whenToPreferThis":"Choose this endpoint when you need aggregated KRX-specific analyst consensus data — particularly the combination of target price statistics, rating distributions, and brokerage revision history — for a single Korean-listed stock. It is uniquely suited for Korean equity research workflows where understanding how multiple local brokerages have shifted their views over time matters. Prefer it over generic financial data APIs when you need the revision log granularity and window-based aggregation specific to KRX-covered companies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:37.813Z","isFirstParty":false}