io.github.LJaysk/kr-dart-events

KR-DART Events — Korean corporate disclosures for AI agents

Real-time DART (Korea's SEC EDGAR equivalent) filing events, structured for machines. Pay per call with USDC via x402 — no account, no API key, no subscription.

Base URL: https://dartapi.ljaysk.com          (machine docs: /llms.txt, /openapi.json)

Korea's exchanges publish ~2,500 corporate filings every trading day, in Korean. This service polls DART every 15 seconds, classifies each filing into 31 machine-readable categories, scores importance 0–1, and serves structured JSON with English labels and English company names.

Endpoints

Endpoint	Price	What you get
GET /v1/events	$0.002	Full filing stream, cursor-based delta
GET /v1/events/material	$0.005	Material filings only (supply contracts, capital raises, CB/BW, control changes, delisting risk, M&A…)
GET /v1/events/{rcept_no}	$0.01	Single filing detail
GET /v1/events/{rcept_no}/document	$0.02	Full original text, parsed to clean plain text (not charged on retrieval failure)
GET /v1/company/{code}/events	$0.005	Per-company timeline (6-digit ticker)
GET /v1/bids	$0.005	KONEPS government procurement bid notices (goods/service/construction/foreign), cursor delta
GET /v1/bids/search	$0.005	Bid search by keyword, type, minimum budget (KRW)
GET /v1/bids/{bid_ntce_no}	$0.01	Bid notice full detail (all raw KONEPS fields)
GET /v1/awards	$0.005	Award results — winner and amount
GET /v1/prespecs	$0.01	Early signal: pre-spec notices, before bid notices
GET /v1/orderplans	$0.01	Earliest signal: agency order plans for the fiscal year
GET /v1/match/{bizno}	$0.05	Personalized matching — company profile + biddable notices, scored
GET /v1/company-awards/{bizno}	$0.02	Company award history — competitor intel

Free: /v1/health, /, /llms.txt, /openapi.json.

Payment: x402 exact scheme, USDC on Base or Solana (Solana fees sponsored by the facilitator — buyer wallets need zero SOL).

Quickstart (see the 402)

curl https://dartapi.ljaysk.com/v1/events/material
# -> HTTP 402 with payment requirements (accepts: base / solana)

Python client (pay + fetch in ~60 lines)

See client_example.py. Fund any EVM wallet with a few cents of USDC on Base, then:

X402_PRIVATE_KEY=0x... python client_example.py /v1/events/material

Standard x402 SDKs (x402-fetch, x402-axios, x402 python) work as-is.

MCP server (use from Claude / any MCP client)

mcp_server.py wraps the API as MCP tools (kr_dart_material_events, kr_dart_all_events, kr_dart_company_timeline, kr_dart_filing_detail).

{
  "mcpServers": {
    "kr-dart-events": {
      "command": "uv",
      "args": ["run", "--with", "mcp,eth-account", "python", "/path/to/mcp_server.py"],
      "env": { "X402_PRIVATE_KEY": "0x..." }
    }
  }
}

Typical agent loop

Poll /v1/events/material?since_cursor=<last> every 60s during KST market hours. New filings appear within ~15s of DART publication. Cost ≈ $2/day.

Notes

• Source: DART open data (attributed). Data only — not investment advice.
• Event index starts 2026-07-20; earlier filings are not indexed.
• server/ contains the full seller implementation (FastAPI + hand-rolled x402 middleware, CDP facilitator with JWT auth) — reference for building your own x402 seller.

License

MIT — see LICENSE. Operated by LJay AI Media Group · contact@ljaysk.com