# DeepSearch Korean Stock Financials API

> DeepSearch Korean Stock Financials 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-09-14).

Retrieves up to 10 years of financial statements and 3 years of daily price history for any KRX-listed stock by ticker symbol

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/financials/%7Bticker%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-korean-stock-financials-api-914b9164
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5v4b1LdcvADw804D-vMFB

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-financials-api-914b9164
```

Example prompt: Pull up the last 10 years of financials for Samsung Electronics — ticker 005930 on KRX — I want to see revenue, operating profit, and net income by fiscal year.

## When to prefer this

Use this endpoint when you need deep historical financial fundamentals (up to 10 years) or daily price history for any of the 2,000+ stocks listed on the Korean Stock Exchange (KRX). It also supports major US exchange symbols (NASDAQ/NYSE). Ideal for equity research, fundamental analysis, and financial modeling of Korean companies. Prefer this over general market data APIs when Korean market coverage and long historical depth are required. Pay-per-query USDC pricing makes it cost-effective for occasional lookups without a subscription.

## Known failure modes

- Invalid or unknown ticker returns 404 or empty periods array
- Non-KRX ticker without exchange parameter may return wrong data
- Payment failure via x402/USDC returns 402 Payment Required
- Rate limiting or network issues return 5xx errors
- Ticker format mismatch (e.g. 5 digits instead of 6) returns no results

## How this service works

Up to 10 years of financials + 3 years of daily price history for all 2,000+ KRX stocks. Pay-per-query with USDC on Base Mainnet — no subscription.

## Output

Returns a JSON object with the ticker symbol and an array of fiscal periods, each containing revenue, net income, operating profit, and fiscal end date, denominated in Korean won (조원). Also includes up to 3 years of daily price history for KRX stocks.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ticker": "005930",
   "exchange": "KRX"
  }
 }
}
```

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "6-digit KRX ticker or NASDAQ/NYSE symbol (e.g. 005930, AAPL)"
      },
      "exchange": {
       "type": "string",
       "description": "Exchange code: KRX (default), NASDAQ, NYSE"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ticker": "005930",
  "periods": [
   {
    "revenue": "133조원",
    "netIncome": "45조원",
    "fiscalEndDate": "2026-03-31",
    "operatingProfit": "57조원"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-korean-stock-financials-api-914b9164/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)