# DeepSearch Korean Stock IR Documents API

> DeepSearch Korean Stock IR Documents 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 investor relations documents (earnings reports, filings) for a specific KRX-listed stock by ticker, with up to 10 years of financial history and 3 years of daily price data.

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/ir/%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-ir-documents-api-ea3d330e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ifDCuXyhLECyhrFBd-ah7

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-ir-documents-api-ea3d330e
```

Example prompt: Pull up the latest investor relations documents for Samsung Electronics — ticker 005930 on KRX — so I can review their most recent earnings disclosures.

## When to prefer this

Choose this endpoint when you need official IR documents (earnings reports, financial filings, investor presentations) for a specific Korean stock listed on KRX, especially when you need historical financial data going back up to 10 years. Ideal for financial research agents, equity analysts, or any workflow requiring primary-source Korean corporate disclosures without a subscription commitment.

## Known failure modes

- Invalid or non-existent KRX ticker returns empty documents array or 404
- Payment failure via x402/USDC results in 402 Payment Required response
- Malformed ticker format (non-6-digit) may return validation error
- Network timeout if CDN PDF links are temporarily unavailable
- Exchange code mismatch may return no results for valid ticker

## 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 requested ticker and an array of IR documents, each containing a document title (in Korean), a PDF URL hosted on DeepSearch CDN, and a publication date. Covers up to 10 years of financials and 3 years of daily price history.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ticker": "000660",
   "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 code"
      },
      "exchange": {
       "type": "string",
       "description": "Exchange code. Default: KRX"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ticker": "005930",
  "documents": [
   {
    "title": "2026년 1분기 경영실적 발표",
    "pdfUrl": "https://ddi-cdn.deepsearch.com/...",
    "publishedAt": "2026-04-30"
   }
  ]
 }
}
```

## More

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