kr-dart-events

# KR-DART Events — Korean corporate disclosures for AI agents

Real-time [DART](https://dart.fss.or.kr) (Korea's SEC EDGAR equivalent) filing events,
structured for machines. Pay per call with USDC via [x402](https://x402.org) —
**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)

```bash
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`](client_example.py). Fund any EVM wallet with a few cents
of USDC on Base, then:

```bash
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`](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`).

```json
{
  "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](LICENSE). Operated by LJay AI Media Group · contact@ljaysk.com