Service
data.go.kr의 금융위원회_지수시세정보 데이터셋을 기반으로 한 한국 주식시장지수(코스피·코스닥 및 관련 지수)의 일별 시세.
99.86%30일 가동률평균 응답180ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-stock-index/bond-indices | Returns one page (default 20, maximum 100 rows) of Korean bond-market index rows (e.g. KIS 종합채권지수) for a trading date given as an ISO 8601 date (YYYY-MM-DD), optionally filtered by exact index_name. Use when you need bond index levels such as total-return, net-price, or market-price index closes, duration, convexity, or yield to maturity. Do NOT use for stock-market indices such as KOSPI or KOSDAQ — use korea-stock-index:stock-indices instead; for derivatives indices use korea-stock-index:derivatives-indices. Returns items[] (date, index_name, total_return_close, net_price_close, zero_reinvestment_close, call_reinvestment_close, market_price_close with their daily changes, duration_years, convexity, yield_to_maturity), total_count, page, limit, has_more. This operation answered to get-bond-market-index before 2026-09-12; that id no longer resolves. The deprecated duration field (renamed duration_years) is served until 2026-10-12. | |
| POST | /v1/korea-stock-index/derivatives-indices | Returns one page (default 20, maximum 100 rows) of Korean derivatives-product index rows (e.g. 코스피 200 선물) for a trading date given as an ISO 8601 date (YYYY-MM-DD), optionally filtered by exact index_name. Use when you need a derivatives index's open, high, low, close, change, fluctuation rate, trading volume, or won-denominated trading value. Do NOT use for stock-market indices such as KOSPI or KOSDAQ — use korea-stock-index:stock-indices instead; for bond indices use korea-stock-index:bond-indices. Returns items[] (date, index_name, close, price_change, fluctuation_rate, open, high, low, trading_volume, trading_value_krw), total_count, page, limit, has_more. This operation answered to get-derivatives-market-index before 2026-09-12; that id no longer resolves. The deprecated trading_value field (renamed trading_value_krw) is served until 2026-10-12. | |
| POST | /v1/korea-stock-index/search-stock-index-by-classification | Finds all stock-market index rows in one index classification (index_class_code, e.g. KOSPI시리즈) on a KRX trading date given as an ISO 8601 date (YYYY-MM-DD), with no index name required, returning each index's name and closing level. Use when you want every index that belongs to a classification such as the KOSPI series. The source has no classification parameter, so every index published for the date is collected and then filtered; total_count, page, limit and has_more all describe the matching rows, so paging through them returns each match exactly once. A page with no matching rows fails with NO_DATA instead of returning empty items. Do NOT use for a single index by exact name — use korea-stock-index:search-stock-index-by-name instead; for the unfiltered list or a combined name-and-classification filter use korea-stock-index:stock-indices. Returns items[] (date, index_name, index_class_code, close), total_count, page, limit, has_more. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-stock-index/search-stock-index-by-name | Finds the single stock-market index row whose name exactly matches index_name (e.g. 코스피) on a KRX trading date given as an ISO 8601 date (YYYY-MM-DD), returning its classification and closing level. Use when you know the exact published index name and need that index's close for a date. Do NOT use for partial or fuzzy name matching — the name must match exactly. Do NOT use to list every index for a date or to filter by classification — use korea-stock-index:stock-indices or korea-stock-index:search-stock-index-by-classification instead. Fails with NO_DATA when no row matches. Returns items[] (date, index_name, index_class_code, close), total_count, page, limit, has_more. |
| POST | /v1/korea-stock-index/stock-indices | Returns one page (default 20, maximum 100 rows) of Korean stock-market index rows (KOSPI, KOSDAQ, and related indices) for a KRX trading date given as an ISO 8601 date (YYYY-MM-DD), optionally narrowed by index_name (exact match, forwarded upstream) and/or index_class_code (applied to the returned page only). Use when you need every index published for a date, or want to combine both filters. Do NOT use for a single index by exact name — use korea-stock-index:search-stock-index-by-name instead; for every index in one classification use korea-stock-index:search-stock-index-by-classification. Do NOT use for bond or derivatives indices — use korea-stock-index:bond-indices or korea-stock-index:derivatives-indices instead. When a filter is given and no row on the requested page matches, fails with NO_DATA instead of returning empty items. Returns items[] (date, index_name, index_class_code, close), total_count, page, limit, has_more. This operation answered to get-stock-market-index before 2026-09-12; that id no longer resolves. |
