# KR-DART Events

> Real-time Korean corporate disclosure (DART) events, structured for AI agents.
> Pay per call with USDC via the x402 protocol (Base or Solana). No account, no API key.

Base URL: https://dartapi.ljaysk.com

## What this is

Korea's corporate disclosure system (DART, run by the Financial Supervisory Service)
publishes ~2,500 filings every trading day, in Korean. This API polls DART every 15
seconds, classifies each filing into 31 machine-readable categories (supply contracts,
capital raises, convertible bonds, control changes, delisting risk, M&A, insolvency...),
scores importance 0-1, and serves them as structured JSON with English category labels
and company name mappings (Korean + English). Source data is Korean public data,
attributed to DART. Data only — no investment advice.

## Endpoints (all GET, paid via x402)

- /v1/events — $0.002. Full filing stream, cursor-based delta polling.
  Params: since_cursor (rcept_no), market (KOSPI|KOSDAQ|KONEX), limit (<=200).
- /v1/events/material — $0.005. Pre-screened material filings only, importance >= 0.65.
  Same params as /v1/events.
- /v1/events/{rcept_no} — $0.01. Single filing detail by DART receipt number.
- /v1/events/{rcept_no}/document — $0.02. FULL TEXT of the original filing,
  parsed from DART's XML to clean plain text (up to 300k chars). Not charged
  if the original document cannot be retrieved.
- /v1/company/{code}/events — $0.005. Timeline for one listed company
  (6-digit ticker or DART corp code).

## Government procurement (KONEPS / Narajangteo) endpoints

Korea's national e-procurement system publishes thousands of bid notices weekly.
Polled every 5 minutes from the official Public Procurement Service open API.

- /v1/bids — $0.005. New bid notices, cursor delta. Params: since_cursor (int),
  bid_type (goods|service|construction|foreign), limit.
- /v1/bids/search — $0.005. Search by keyword, bid_type, min_budget (KRW), days (<=60).
- /v1/bids/{bid_ntce_no} — $0.01. Full notice detail with all raw KONEPS fields.
- /v1/awards — $0.005. Award results (winner, amount), cursor delta.
- /v1/prespecs — $0.01. PRE-specification notices — the stage BEFORE a bid notice.
  Early signal for upcoming tenders. Params: since_cursor, keyword, bid_type, limit.
- /v1/orderplans — $0.01. Agency procurement ORDER PLANS for the fiscal year —
  the EARLIEST signal, before pre-specs and notices. Same params.
- /v1/match/{bizno} — $0.05. PERSONALIZED matching: give a Korean business
  registration number, get the company's official KONEPS profile (industries,
  supply products, region) + open bids / pre-specs / order plans it can
  actually bid on, scored with reasons. Not charged if company unknown.
- /v1/company-awards/{bizno} — $0.02. Award history for one company —
  competitor intelligence (what they won, at what amount).

Free: /v1/health (status), / (docs), /llms.txt (this file), /openapi.json (schema).

## How to pay (x402)

1. GET any paid endpoint -> HTTP 402 with `accepts` (payment requirements).
2. Sign an exact-scheme USDC authorization (EIP-3009 on Base, or Solana) for the
   quoted amount to the quoted payTo.
3. Retry with the signed payload base64-encoded in the `X-PAYMENT` header.
4. Response 200 + your data + `X-PAYMENT-RESPONSE` settlement receipt.
Works with standard x402 client SDKs (x402-fetch, x402-axios, x402 python).

## Typical agent loop

Poll /v1/events/material every 60s with since_cursor from the previous response.
Cost: ~$2/day during Korean market hours. New filings appear within ~15s of DART.

Contact: contact@ljaysk.com