API contract

Use ?preview=true for no-key 3-row exploration. For deeper testing, issue a free pilot key and send Authorization: Bearer <api_key>. Paddle is intentionally deferred; the dashboard measures which datasets agents actually request before paid checkout is added.

/v1/products

Korean commerce search APIs

q, category, sort, source
/v1/realestate

Korea Ministry of Land (MOLIT)

region, yyyymm, min_price_usd, max_price_usd
/v1/companies

OpenDART

corp, report, year
/v1/stocks

Korean equity market overview bundle

ticker, market, sector
/v1/stocks/prices

KRX/FSC daily and intraday stock price feeds

ticker, market, date_from, date_to, adjusted
/v1/stocks/fundamentals

OpenDART financial statements and derived valuation metrics

ticker, corp, year, quarter, metric
/v1/stocks/disclosures

OpenDART disclosure filings

ticker, corp, report, date_from, date_to
/v1/stocks/flows

KRX investor flow, program trading, short selling, and lending balance feeds

ticker, market, investor, date_from, date_to
/v1/stocks/screeners

K-Data Gate derived Korean equity screening signals

preset, market, sector, min_volume
/v1/fx-macro

Bank of Korea ECOS

indicator, period
/v1/trends

Naver DataLab

keyword, category, period
/v1/tourism

Korea Tourism Organization TourAPI

area, type, lang
/v1/weather

Korea Meteorological Administration

city, type

Equity product groups

/v1/stocks/prices: daily and intraday-ready OHLCV, traded value, market filters.

/v1/stocks/fundamentals: revenue, income, EPS, PER, PBR, ROE, debt ratio.

/v1/stocks/disclosures: DART filings, categories, summaries, receipt URLs.

/v1/stocks/flows: foreign, institution, retail, program, short, lending balance.

/v1/stocks/screeners: derived signals for valuation, volume, dividend, earnings, and accumulation presets.

Examples

curl "http://localhost:3000/api/v1/stocks/prices?preview=true&ticker=005930" curl -X POST http://localhost:3000/api/keys \ -H "content-type: application/json" \ -d '{"email":"you@example.com","plan":"free"}' curl "http://localhost:3000/api/v1/stocks/prices?ticker=005930" -H "Authorization: Bearer kg_test_..."

MCP registration

{ "mcpServers": { "kdata-gate": { "command": "npm", "args": ["run", "mcp"], "env": { "KDATA_API_KEY": "kg_test_...", "NEXT_PUBLIC_BASE_URL": "http://localhost:3000" } } } }