# DeepSearch Korean Market Snapshot

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

Returns a single-call snapshot of the Korean stock market including KOSPI/KOSDAQ investor flows, VKOSPI volatility, put/call ratio, investor deposits, forced-liquidation ratio, and index valuation metrics (PER, PBR, dividend yield).

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/market/kr?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-korean-market-snapshot-85396c0a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DRhZLwya5dEetwHgTgVE5

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-market-snapshot-85396c0a
```

Example prompt: Give me a full Korean market snapshot right now — I want to see whether foreigners and institutions are net buyers today, where the VKOSPI sits relative to its 20-day range, the KOSPI200 put/call ratio, investor deposit levels, and the current PER, PBR, and dividend yield for both KOSPI and KOSDAQ.

## When to prefer this

Use this endpoint when you need a comprehensive, single-call overview of the Korean equity market rather than per-stock data. It is the right choice for morning briefings, market regime detection (risk-on vs risk-off), monitoring institutional vs retail sentiment in Korea, or checking whether Korean market valuation is stretched or cheap. Prefer this over individual stock endpoints when the user's question is about the overall Korean market rather than a specific company.

## Known failure modes

- Market data not yet available for the current trading day (pre-market or holiday)
- Payment of $0.05 USDC not completed — 402 Payment Required error
- Malformed or unexpected schema if upstream KRX data feed is delayed
- Rate limiting if too many calls are made in rapid succession
- Missing KOSDAQ flows or valuation data if not published by exchange on that date

## How this service works

One-call snapshot of the Korean stock market: KOSPI and KOSDAQ net buying by foreigners / institutions / individuals (1 and 5 days), VKOSPI volatility index vs its 20-day range, KOSPI200 options put/call ratio, investor cash deposits and forced-liquidation ratio, and KOSPI / KOSDAQ index PER, PBR and dividend yield.

## Output

A JSON object timestamped with the snapshot date, containing: VKOSPI and its 20-day high/low/average; KOSPI200 options put/call ratio with 5-day average; net investor flows (foreigners, institutions, individuals) for KOSPI over 1-day and 5-day windows; index valuation (PER, PBR, dividend yield %) for KOSPI and KOSDAQ; and investor deposit balance in KRW plus forced liquidation ratio percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-09-30",
  "packType": "market-kr",
  "volatility": {
   "avg20d": 41.2,
   "low20d": 35.1,
   "vkospi": 43.03,
   "high20d": 47.9
  },
  "putCallRatio": {
   "avg5d": 0.66,
   "kospi200Options": 0.61
  },
  "investorFlows": {
   "KOSPI": {
    "1d": {
     "foreigner": 523000000000,
     "individual": -401000000000,
     "institutional_total": -120000000000
    }
   }
  },
  "indexValuation": {
   "KOSPI": {
    "pbr": 1.71,
    "per": 11.45,
    "date": "2026-09-29",
    "dividendYieldPct": 0.92
   }
  },
  "investorDeposits": {
   "date": "2026-09-29",
   "depositsKRW": 107725670498218,
   "forcedLiquidationRatioPct": 1.4
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-korean-market-snapshot-85396c0a/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)