API Reference

The K-Market Insight API provides structured Korean equity intelligence — corporate events, sector signals, and market radar — via a REST interface. All responses are JSON. Timestamps are ISO 8601 UTC.

Rate Limits

Rate limits are enforced per API key. If you exceed your limit, the API returns HTTP 429 with a Retry-After header indicating seconds until the next window.

Pagination

Endpoints that return lists use cursor-based pagination. Pass limit (max 100) to control page size. When more pages exist, the response includes a next_cursor string — pass it as the cursor parameter in your next request.

// Page 1
const page1 = await fetch('/v1/events?limit=20', { headers }).then(r => r.json());
// page1.next_cursor = "eyJpZCI6Im..."

// Page 2
const page2 = await fetch(`/v1/events?limit=20&cursor=${page1.next_cursor}`, { headers })
  .then(r => r.json());
// page2.next_cursor = null  →  last page