---
name: krx-market-data
description: 한국 상장 종목의 기준일별 종가·거래량·시가총액·상장주식수와 지수·ETF·채권·파생 등 KRX 일별 자료를 k-deal-skill 로컬 도구로 조회할 때 사용한다.
metadata:
  version: "2.0.2"
---

# KRX 시장 자료 조회

이 스킬은 이 PC에서 사용자 본인 API 키로 도는 **k-deal-skill** 로컬 MCP의 도구만 쓴다. 키 값은 환경변수(`DART_API_KEY`, `KRX_API_KEY`, `DATA_GO_KR_KEY`, `LAW_OC`)에 있으므로 대화에 출력하거나 사용자에게 묻지 않고, 코드를 실행해 원천을 직접 부르지 않는다.

## 도구 순서

1. 종목코드(6자리)와 시장(KOSPI·KOSDAQ·KONEX)을 확정한다. 회사명만 있으면 `dart_corp_search`로 종목코드를 찾는다. 보통주·우선주는 코드가 다르다.
2. 기준일을 정한다. 사용자가 날짜를 주지 않았으면 오늘 시세를 쓰지 말고 어느 날짜 기준인지 확인하거나, 재무제표 기준일 등 질문에 맞는 날짜를 골라 적는다.
3. 도구를 고른다.

| 질문 | 도구 | 필수 값 |
|---|---|---|
| 종가·거래량·거래대금·시가총액·상장주식수 | `krx_trade` | `market`, `date`(YYYYMMDD), `codes`(최대 50개) |
| 종목 기본정보(상장일, 액면가, 주식 종류 등) | `krx_base` | `market`, `date`, `codes` |
| 지수, ETF·ETN·ELW, 채권, 파생, 금·석유·배출권, ESG | `krx_daily` | `api`, `date`, 필요 시 `codes`·`name_contains` |

`krx_daily`의 `api` 31종은 도구 설명에 있다.

## 근거와 해석

- 기준일(`basDd`), 시장, 원자료 필드 이름과 단위를 보존한다. 조회 기준일, 응답의 기준일, 조회 시각은 서로 다르다.
- 일별 자료이며 실시간 시세가 아니다.
- 빈 결과는 휴장일, 아직 올라오지 않은 날짜, 시장·코드 불일치 등 여러 이유가 있다. 휴장일이나 0으로 단정하지 않고, 직전 영업일로 다시 조회했으면 그 사실을 적는다.
- 시가총액을 직접 계산할 때는 주식 수와 주식 종류를 확인한다. 자기주식, 발행주식, 희석주식을 구분하며 이 자료만으로 완전희석 지분을 계산하지 않는다.

## 거절과 오류

- `not_approved`는 그 KRX 서비스의 이용신청이 승인되지 않았다는 뜻이다. 자료가 없다는 뜻이 아니다.
- `not_connected`는 그 원천의 키가 환경변수에 없다는 뜻이다. `mrm_connection_status`(값 없이 유무만)로 확인하고 키 발급·설정을 안내한다. `rate_limited`·`http_429`는 원천 기관의 호출 제한이니 잠시 뒤 다시 조회한다.
- 대화에 k-deal-skill 도구(`mrm_connection_status` 등)가 보이지 않으면 로컬 MCP가 연결되지 않은 것이다. 값을 기억으로 채우지 않는다.

출처: [KRX Open API](https://openapi.krx.co.kr/). KRX 약관은 비상업적 이용과 제3자 제공 금지를 정하고 있다.