# Korea Filings — Search Korean Disclosures by Ticker

> Korea Filings — Search Korean Disclosures by Ticker is a paid API for AI agents from api.koreafilings.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-12).

Retrieve AI-summarized DART filings for a KRX-listed company by its six-digit ticker, paying per call in USDC via x402 on Base

## Facts

- Endpoint: GET https://api.koreafilings.com/v1/disclosures/by-ticker?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korea-filings-search-korean-disclosures-by-ticker-5eb4c005
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rHumbUou8eCyEG03D4D6V

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 korea-filings-search-korean-disclosures-by-ticker-5eb4c005
```

Example prompt: Pull the 10 most recent DART filings for Samsung Electronics (ticker 005930) from Korea Filings and give me English summaries of each one.

## When to prefer this

Use this endpoint when you need English-language, AI-summarized DART filings for a specific KRX-listed company identified by its six-digit ticker. It is the right choice for autonomous agents that want structured, actionable Korean disclosure data without API key registration, paying only for what they consume via micropayment on Base. It is preferable to raw DART scraping because it returns pre-parsed, English-summarized, importance-scored results ready for downstream reasoning.

## Known failure modes

- Invalid or non-existent KRX ticker returns an error or empty results
- Limit value outside 1–50 range causes a validation error
- Payment failure via x402 results in a 402 Payment Required response
- No recent filings available for the ticker returns an empty array
- Network or DART upstream outage causes a 503 or timeout

## How this service works

AI summaries for the most recent DART filings of a Korean ticker

## Output

Returns a JSON object per filing including: receipt number, event type classification, an AI-generated English summary of the disclosure, sector tags, ticker tags, an importance score (1–10), a list of who the filing is actionable for (e.g. traders), and a timestamp of when the summary was generated. Up to 50 filings can be returned per call; the cost scales at $0.005 USDC per filing requested.

## Example request

```json
{
 "limit": 5,
 "ticker": "005930"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max filings to return (1–50, default 5). Final price is 0.005 × limit USDC."
  },
  "ticker": {
   "type": "string",
   "description": "Six-digit KRX ticker (e.g. 005930 for Samsung Electronics). Resolve from a company name first via the free /v1/companies?q={name} endpoint."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rcptNo": "20260424900874",
  "eventType": "OTHER",
  "summaryEn": "AI-generated English summary of the disclosure.",
  "sectorTags": [
   "Capital Goods"
  ],
  "tickerTags": [
   "095440"
  ],
  "generatedAt": "2026-04-24T09:00:00Z",
  "actionableFor": [
   "traders"
  ],
  "importanceScore": 7
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korea-filings-search-korean-disclosures-by-ticker-5eb4c005/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.koreafilings.com](https://www.zero.xyz/host/api.koreafilings.com/llms.txt)