# DeepSearch Korean Stock Market Sentiment

> DeepSearch Korean Stock Market Sentiment is a paid API for AI agents from x402.deepsearch.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-12).

Returns a composite sentiment index and multi-signal dashboard for the Korean stock market (KRX) over a configurable look-back window of 1–30 days, including news mood percentile, foreign/institutional/retail money flows, VKOSPI, put/call ratio, forced-liquidation ratio, and a Korean-language evidence summary.

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/market-sentiment?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-korean-stock-market-sentiment-adda5629
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y-RmHqgDGPWlet_Mrl0uc

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 deepsearch-korean-stock-market-sentiment-adda5629
```

Example prompt: What's the current investor sentiment in the Korean stock market? Give me the full picture — composite index, foreign and retail money flows, VKOSPI, put/call ratio, and whether smart money is diverging from retail — looking back over the last 14 days.

## When to prefer this

Choose this endpoint when you need a holistic, multi-signal sentiment snapshot of the Korean (KRX) equity market rather than sentiment for a single stock. It is the right choice when you need composite scoring alongside granular flow data (foreign, institutional, retail), volatility signals (VKOSPI, put/call), and a Korean-language narrative summary — all in one call. Prefer alternatives if you need per-stock sentiment, US or global market sentiment, or raw news articles.

## Known failure modes

- Invalid 'days' parameter outside 1–30 range returns an error
- Payment not fulfilled (402 Payment Required) if x402 USDC payment is not attached
- Stale or missing market data for very recent days may reduce indicator completeness
- Non-GET methods will be rejected

## How this service works

Korean stock market investor sentiment over the last N days (default 7): news mood percentile vs the past year, foreign / institutional / retail flows, VKOSPI, put/call ratio and forced-liquidation ratio, whether news and money flows diverge, a composite 0-100 sentiment index, and a 9-line Korean evidence summary. Indicators only — no buy/sell recommendations.

## Output

Returns a JSON object with a composite sentiment index (0–100) and a labeled sentiment state (e.g. '탐욕' for greed), individual evidence metrics (VKOSPI, put/call ratio, forced-liquidation ratio, foreign/institutional/retail investor net flows, news mood percentile vs. past year), a flag indicating smart-money vs. retail divergence, and up to 9 Korean-language summary lines explaining the evidence. No buy/sell recommendations are included.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "days": {
       "type": "string",
       "description": "Look-back window in days, 1-30 (default 7)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "lines": {
    "l1": "[투자심리 상태] 탐욕 (통합 센티먼트 Index: 66.5/100)",
    "l6": "▶ 스마트머니 vs 리테일 괴리: 외국인 투자자가 순매도를 주도하고 개인 투자자가 순매수를 주도해 자금 방향이 엇갈린다"
   },
   "evidence": {
    "risk_signals": {
     "vkospi": {},
     "put_call_ratio": {}
    },
    "investor_flow": {}
   },
   "sentiment_index": 66.5,
   "sentiment_state": "탐욕"
  },
  "packType": "market-sentiment"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-korean-stock-market-sentiment-adda5629/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsearch.com](https://www.zero.xyz/host/x402.deepsearch.com/llms.txt)