Skip to content
MCP ThesaurusMCP Thesaurus

kr dart events

CommunityIncomplete39/100Claim

oci ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4stdioMITupdated 1mo ago

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.

SourceWebsite

What can you do with 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