# KRX Analyst Consensus API

> KRX Analyst Consensus API is a paid API for AI agents from k-data-x402-production.theblack1022.workers.dev, paid per call via x402, $0.12/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://k-data-x402-production.theblack1022.workers.dev/api/research/consensus/:ticker
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/krx-analyst-consensus-api-fb2b30bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CrNQFStaemqSh8bGFX_ID

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability krx-analyst-consensus-api-fb2b30bf
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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).

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/krx-analyst-consensus-api-fb2b30bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from k-data-x402-production.theblack1022.workers.dev](https://www.zero.xyz/host/k-data-x402-production.theblack1022.workers.dev/llms.txt)