{
  "markdown": "# KR-DART Events — Korean corporate disclosures for AI agents\n\nReal-time [DART](https://dart.fss.or.kr) (Korea's SEC EDGAR equivalent) filing events,\nstructured for machines. Pay per call with USDC via [x402](https://x402.org) —\n**no account, no API key, no subscription.**\n\n```\nBase URL: https://dartapi.ljaysk.com          (machine docs: /llms.txt, /openapi.json)\n```\n\nKorea's exchanges publish ~2,500 corporate filings every trading day, in Korean.\nThis service polls DART every 15 seconds, classifies each filing into 31\nmachine-readable categories, scores importance 0–1, and serves structured JSON with\nEnglish labels and English company names.\n\n## Endpoints\n\n| Endpoint | Price | What you get |\n|---|---|---|\n| `GET /v1/events` | $0.002 | Full filing stream, cursor-based delta |\n| `GET /v1/events/material` | $0.005 | Material filings only (supply contracts, capital raises, CB/BW, control changes, delisting risk, M&A…) |\n| `GET /v1/events/{rcept_no}` | $0.01 | Single filing detail |\n| `GET /v1/events/{rcept_no}/document` | $0.02 | Full original text, parsed to clean plain text (not charged on retrieval failure) |\n| `GET /v1/company/{code}/events` | $0.005 | Per-company timeline (6-digit ticker) |\n| `GET /v1/bids` | $0.005 | **KONEPS government procurement** bid notices (goods/service/construction/foreign), cursor delta |\n| `GET /v1/bids/search` | $0.005 | Bid search by keyword, type, minimum budget (KRW) |\n| `GET /v1/bids/{bid_ntce_no}` | $0.01 | Bid notice full detail (all raw KONEPS fields) |\n| `GET /v1/awards` | $0.005 | Award results — winner and amount |\n| `GET /v1/prespecs` | $0.01 | **Early signal**: pre-spec notices, before bid notices |\n| `GET /v1/orderplans` | $0.01 | **Earliest signal**: agency order plans for the fiscal year |\n| `GET /v1/match/{bizno}` | $0.05 | **Personalized matching** — company profile + biddable notices, scored |\n| `GET /v1/company-awards/{bizno}` | $0.02 | Company award history — competitor intel |\n\nFree: `/v1/health`, `/`, `/llms.txt`, `/openapi.json`.\n\nPayment: x402 `exact` scheme, **USDC on Base or Solana** (Solana fees sponsored by\nthe facilitator — buyer wallets need zero SOL).\n\n## Quickstart (see the 402)\n\n```bash\ncurl https://dartapi.ljaysk.com/v1/events/material\n# -> HTTP 402 with payment requirements (accepts: base / solana)\n```\n\n## Python client (pay + fetch in ~60 lines)\n\nSee [`client_example.py`](client_example.py). Fund any EVM wallet with a few cents\nof USDC on Base, then:\n\n```bash\nX402_PRIVATE_KEY=0x... python client_example.py /v1/events/material\n```\n\nStandard x402 SDKs (`x402-fetch`, `x402-axios`, `x402` python) work as-is.\n\n## MCP server (use from Claude / any MCP client)\n\n[`mcp_server.py`](mcp_server.py) wraps the API as MCP tools\n(`kr_dart_material_events`, `kr_dart_all_events`, `kr_dart_company_timeline`,\n`kr_dart_filing_detail`).\n\n```json\n{\n  \"mcpServers\": {\n    \"kr-dart-events\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--with\", \"mcp,eth-account\", \"python\", \"/path/to/mcp_server.py\"],\n      \"env\": { \"X402_PRIVATE_KEY\": \"0x...\" }\n    }\n  }\n}\n```\n\n## Typical agent loop\n\nPoll `/v1/events/material?since_cursor=<last>` every 60s during KST market hours.\nNew filings appear within ~15s of DART publication. Cost ≈ $2/day.\n\n## Notes\n\n- Source: DART open data (attributed). **Data only — not investment advice.**\n- Event index starts 2026-07-20; earlier filings are not indexed.\n- `server/` contains the full seller implementation (FastAPI + hand-rolled x402\n  middleware, CDP facilitator with JWT auth) — reference for building your own\n  x402 seller.\n\n## License\n\nMIT — see [LICENSE](LICENSE). Operated by LJay AI Media Group · contact@ljaysk.com\n",
  "bytes": 3655,
  "sha": "ccc43abde84aeda8e48264aed6d15ba0c63cf1d9e2e7c62f6aac31014a961966",
  "repo_slug": "ljaysk/kr-dart-events",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ljaysk_kr_dart_events_2872ea50/readme"
}