KOREA FILINGS

AI summaries of Korean corporate disclosures, paid per call.

Machine-ready English summaries of Korean DART filings for autonomous AI agents, quant funds, and research platforms covering Asian equities. No API key. No subscription. Payment is authentication.

x402 v2 USDC on Base 300–500 filings/day

Why this exists

Korea's Financial Supervisory Service publishes 300–500 corporate disclosures every day across KOSPI and KOSDAQ. The feed is free. It is also in Korean, structured as PDFs pinned to XML metadata, and full of domain vocabulary — 유상증자, 전환사채, 지주사 전환 — that general-purpose LLMs translate badly.

For an AI agent or a quantitative desk, raw DART is unusable without a Korean NLP pipeline, a translation layer, and an importance-scoring model. Korea Filings does that work once per filing, caches the result forever, and sells it per call.

How it works

Your agent → GET /v1/disclosures/{rcptNo}/summary
← 402 Payment Required
←    { scheme, network, amount, payTo, asset, ... }

Sign the payment authorisation with your wallet (EIP-3009)

Your agent → GET /v1/disclosures/{rcptNo}/summary
    X-PAYMENT: <base64 signed payload>
← 200 OK + X-PAYMENT-RESPONSE
←    { summaryEn, importanceScore, eventType, sectorTags, tickerTags, ... }

The x402 protocol routes the payment through Coinbase's facilitator, which validates your signature on-chain and settles USDC in a single transaction. The server never holds your private key. You never hold an API key. Every call is audited on-chain.

What you get

One call returns a structured JSON object:

{
  "rcptNo": "20260424900874",
  "summaryEn": "Global SM's stock trading will be temporarily
                suspended on April 24, 2026, due to a change in
                electronic registration related to a stock
                consolidation or split. ...",
  "importanceScore": 10,
  "eventType": "OTHER",
  "sectorTags": ["Capital Goods"],
  "tickerTags": ["095440"],
  "actionableFor": ["traders", "long_term_investors"],
  "generatedAt": "2026-04-24T08:47:51Z"
}

summaryEn — paraphrased English, never a verbatim translation, capped at 400 characters.
importanceScore — 1 for routine housekeeping, 10 for market-moving events.
eventType — canonical UPPER_SNAKE_CASE labels (RIGHTS_OFFERING, MERGER, DIVIDEND_DECISION, etc).
sectorTags, tickerTags — GICS-style sectors and 6-digit Korean stock codes.
actionableFor — which audience should care (traders, long_term_investors, governance_analysts).

Pricing

Per call, in USDC on Base. No minimums, no monthly fee, no volume tiers.

Endpoint	Method	Price (USDC)
/v1/disclosures/{rcptNo}/summary	GET	0.005

Canonical source: api.koreafilings.com/v1/pricing — machine-readable JSON with the current recipient wallet, network, and USDC contract.

Try it

Inspect the 402 without paying:

curl https://api.koreafilings.com/v1/disclosures/20260424900874/summary

Or with a Python x402 client:

from x402 import Client

client = Client(private_key="0x...")  # test wallet, Base Sepolia
resp = client.get("https://api.koreafilings.com/v1/disclosures/20260424900874/summary")
print(resp.json()["summaryEn"])

First production settlement

A live 0.005 USDC settlement from this deployment:

0x1dbf9885194261e1ad64be8205897ef9c5335ad254921b337c343c23d34b0a72

Base Sepolia testnet — mainnet switchover at launch.

Status

Building in the open. Base Sepolia testnet live today, Base mainnet at launch. SDKs (Python, TypeScript) and an MCP server are next. Follow along — or ping any time with questions.