# DeepSearch Korea/US Stock Intelligence – Investor Flows API

> DeepSearch Korea/US Stock Intelligence – Investor Flows API 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-12).

Returns investor flow data for a KRX-listed stock: net buy/sell by foreigner, individual, and institutional investors, plus block trades and short-selling statistics.

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/flows/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-korea-us-stock-intelligence-investor-flows-api-2a565d8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-n6wgdFE3r5f9Rz1WYkEP

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-korea-us-stock-intelligence-investor-flows-api-2a565d8e
```

Example prompt: Pull the investor flow breakdown for Samsung Electronics (ticker 005930) on KRX — I want to see how much foreigners, individuals, and institutions are net buying or selling, plus any block trades and short selling activity today.

## When to prefer this

Use this endpoint when you need granular investor-type flow data (foreigner vs. retail vs. institutional net buy/sell) for a specific KRX-listed Korean stock, especially to detect unusual accumulation, distribution, block trades, or short-selling pressure. Prefer this over the full company report endpoint when you only need flow/sentiment signals and want to minimize cost ($0.05 vs $0.30+). Not suitable for US stock flows or crypto assets.

## Known failure modes

- Invalid or unrecognized KRX ticker returns an error or empty response
- Payment failure (insufficient USDC balance on Base Mainnet) results in 402 response
- Data not yet available for the current trading day (market still open or settlement delay)
- Non-KRX tickers (e.g. NYSE, NASDAQ) are not supported by this endpoint
- Network timeout or upstream data feed outage

## How this service works

Korean (KRX) stock data for AI agents: analyst consensus, investor flows, market pulse, knowledge-graph signals (why a stock moved, hot themes, theme revenue evidence), 10-year financials and 3-year prices, plus US fundamentals and SEC filings. Pay per call in USDC on Base Mainnet — no subscription, no API key.

## Output

A JSON object containing: the stock's ticker and name, the as-of date, a net buy breakdown (1-day window) split into foreigner, individual, and institutional flows in KRW (positive = net buy, negative = net sell), an array of block trade records (date, volume, closing price in KRW, change percent, share of total volume), and an array of short selling records (date, volume, amount in KRW, share of total volume).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-09-30",
  "name": "삼성전자",
  "unit": "KRW, net buy (+) / net sell (−)",
  "netBuy": {
   "1d": {
    "foreigner": 412000000000,
    "individual": -323904661250,
    "institutional_total": -8254030500
   }
  },
  "ticker": "005930",
  "packType": "flows",
  "blockTrades": [
   {
    "date": "2026-09-30",
    "volume": 290794,
    "closeKRW": 272500,
    "changePct": 0.93,
    "shareOfVolumePct": 1.82
   }
  ],
  "shortSelling": [
   {
    "date": "2026-09-30",
    "volume": 863316,
    "amountKRW": 233476662500,
    "shareOfVolumePct": 4.32
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-korea-us-stock-intelligence-investor-flows-api-2a565d8e/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)