data-stock

KRX 한국 주식 검색·시세

KRX(한국거래소) 상장 종목 검색, 종목 기본정보, 일별 시세를 조회합니다. moai-coworker의 DART(공시)를 보완하는 시세 데이터로 활용합니다.

본 스킬은 NomaDamas k-skill korean-stock-search (MIT) 기반이며, upstream 설계 참고는 jjlabsio/korea-stock-mcp입니다. KRX_API_KEY는 프록시 서버에서만 관리하므로 사용자 발급 불필요.

When to use / When not to use

사용: 종목 검색(이름·코드), 종목 기본정보, 일별 종가·거래량·시가총액, KRX 공식 데이터 기반 단순 시세 조회.

사용 금지: 미국·일본·가상자산 등 비한국 주식, 실시간 체결·호가·분봉, 재무제표·공시 원문(→ DART MCP 사용), 투자 자문·매수 추천.

Inputs

• q: 종목명/종목코드 검색어 (search endpoint)
• market: KOSPI | KOSDAQ | KONEX
• code: 종목코드 (보통 6자리, 예: 005930)
• bas_dd: 기준일 YYYYMMDD (없으면 KST 오늘. 휴장일이면 최근 영업일로 재시도)
• limit: 검색 결과 수 (기본 10, 최대 20)

Prerequisites

사용자 측 필수 시크릿 없음.

• KSKILL_PROXY_BASE_URL (선택): self-host 시
• 운영 측 KRX_API_KEY는 프록시 서버 환경에만 둡니다

Endpoints

GET /v1/korean-stock/search?q={검색어}&bas_dd={YYYYMMDD}
GET /v1/korean-stock/base-info?market={KOSPI|KOSDAQ|KONEX}&code={코드}&bas_dd={YYYYMMDD}
GET /v1/korean-stock/trade-info?market={KOSPI|KOSDAQ|KONEX}&code={코드}&bas_dd={YYYYMMDD}

Examples

# 종목 검색
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/search' \
  --data-urlencode 'q=삼성전자' --data-urlencode 'bas_dd=20260408'

# 종목 기본정보
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/base-info' \
  --data-urlencode 'market=KOSPI' --data-urlencode 'code=005930' \
  --data-urlencode 'bas_dd=20260408'

# 일별 시세
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/trade-info' \
  --data-urlencode 'market=KOSPI' --data-urlencode 'code=005930' \
  --data-urlencode 'bas_dd=20260408'

Response shape

검색:

{
  "items": [
    {
      "market": "KOSPI",
      "code": "005930",
      "standard_code": "KR7005930003",
      "name": "삼성전자",
      "english_name": "Samsung Electronics",
      "listed_at": "1975-06-11"
    }
  ]
}

일별 시세:

{
  "item": {
    "market": "KOSPI",
    "code": "005930",
    "base_date": "20260408",
    "name": "삼성전자",
    "close_price": 84000,
    "change_price": 1000,
    "fluctuation_rate": 1.2,
    "open_price": 83000,
    "high_price": 84500,
    "low_price": 82800,
    "trading_volume": 12345678,
    "trading_value": 1030000000000,
    "market_cap": 500000000000000
  }
}