{"openapi": "3.1.0", "info": {"title": "한국주식데이터 공개 데이터 API", "version": "20260805", "description": "KOSPI·KOSDAQ 확정 종가(T+1)·DART 공시·실측 분기 실적을 매 거래일 18:10 KST 에 정적 JSON 으로 발행합니다. 인증·API 키·요청 제한 없음, CORS 개방. ★시세는 실시간이 아닌 전 영업일 확정 종가입니다. null 은 '미제공'이며 0 과 다릅니다. 큰 파일은 AI fetch 도구에서 잘릴 수 있으니 150KB 미만 소형판을 우선 쓰세요(안내: index.json 의 fetch_guide). 정보 제공 목적이며 투자 권유가 아닙니다.", "contact": {"name": "한국주식데이터", "url": "https://aikstockdata.com/about"}, "license": {"name": "공공데이터(DART·금융위) 가공물 — 출처 표기 후 자유 이용(영리 포함)", "url": "https://aikstockdata.com/terms"}}, "servers": [{"url": "https://aikstockdata.com"}], "paths": {"/data/public/index.json": {"get": {"summary": "전체 카탈로그(여기서 시작)", "description": "파일 목록·크기(file_bytes)·신선도(freshness)·파이프라인 상태·아카이브 날짜.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/today.json": {"get": {"summary": "오늘의 시장 다이제스트", "description": "등락 폭·주요 공시 TOP3·성장 랭킹·실적 집계 — '오늘 시장 어땠어?'의 정답 파일.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"$ref": "https://aikstockdata.com/data/public/schemas/today.schema.json"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/s/{code}.json": {"get": {"summary": "종목 상세(소형 ~5KB)", "description": "확정 종가·시가총액·DART 실측 분기 실적·최근 공시·기계 신호.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"$ref": "https://aikstockdata.com/data/public/schemas/stock.schema.json"}}}}, "404": {"description": "없는 종목코드/날짜"}}, "parameters": [{"name": "code", "in": "path", "required": true, "description": "종목코드 6자리 (예: 005930=삼성전자). 전체 목록은 search_index_min.json", "schema": {"type": "string", "pattern": "^[0-9A-Z]{6}$"}}]}}, "/data/public/s/{code}_history.json": {"get": {"summary": "종목별 1년 일별 시계열(~7KB)", "description": "최대 250거래일 [date, close, volume] 배열. 휴장·무거래일은 행이 없음.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}, "parameters": [{"name": "code", "in": "path", "required": true, "description": "종목코드 6자리 (예: 005930=삼성전자). 전체 목록은 search_index_min.json", "schema": {"type": "string", "pattern": "^[0-9A-Z]{6}$"}}]}}, "/data/public/quotes_top300.json": {"get": {"summary": "시가총액 상위 300", "description": "내림차순 정렬 보장 — '시총 상위 N' 질문은 이 파일.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/quotes_slim.json": {"get": {"summary": "전 종목 경량 시세", "description": "핵심 6필드. ★파일 크기 약 196KB — AI fetch 도구에서 잘릴 수 있음. 소형판을 우선 사용: quotes_top300.json", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"$ref": "https://aikstockdata.com/data/public/schemas/quotes_slim.schema.json"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/quotes.json": {"get": {"summary": "전 종목 시세 전체판", "description": "확정 종가·거래량·시가총액 전체 필드. ★파일 크기 약 388KB — AI fetch 도구에서 잘릴 수 있음. 소형판을 우선 사용: quotes_slim.json · quotes_top300.json", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/disclosures_top100.json": {"get": {"summary": "주요 공시 TOP100(중요도순)", "description": "쉬운 말 풀이·중요도 점수 포함, 재무 원장 제외(~80KB).", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/disclosures.json": {"get": {"summary": "공시 브리핑 전체", "description": "최근 7일 전 건 + 재무 원장. ★파일 크기 약 477KB — AI fetch 도구에서 잘릴 수 있음. 소형판을 우선 사용: disclosures_top100.json", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/rankings.json": {"get": {"summary": "랭킹", "description": "성장 TOP8·조용한 실적주·52주 신고저 — 산식 성분 공개(기계 산정, 추천 아님).", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/earnings.json": {"get": {"summary": "어닝 스코어보드", "description": "실적 공시 롤링 120일 — 매출·영업이익·순이익과 전년 대비. ★파일 크기 약 251KB — AI fetch 도구에서 잘릴 수 있음. 소형판을 우선 사용: earnings_recent60.json", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/earnings_recent60.json": {"get": {"summary": "어닝 스코어보드 소형판(최근 60건)", "description": "earnings.json 의 잘림 안전 소형판 — 재무 원장(fin)을 빼고 사실 문장과 매출·영업이익 증감률만. 전체는 earnings.json.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/disclosure_impact.json": {"get": {"summary": "공시 유형별 이후 주가 경로", "description": "공시 접수일 종가 대비 1·5·20거래일 뒤 시장조정 수익률(종목 − 소속 시장 지수)의 유형별 중앙값 + 접수번호별 값(종목·유형 포함 — 유형별 재집계 가능). 과거 사실의 사후 집계이며 인과·예측이 아님. ★파일 크기 약 319KB — AI fetch 도구에서 잘릴 수 있음. 소형판을 우선 사용: disclosure_impact_summary.json", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/disclosure_impact_summary.json": {"get": {"summary": "공시 유형별 이후 주가 경로 소형판", "description": "disclosure_impact.json 에서 접수번호별 값(per_event)을 뺀 집계 전용판. 유형별 중앙값만 필요하면 이것을 쓴다.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/search_index_min.json": {"get": {"summary": "종목 인덱스 경량판(~82KB)", "description": "이름→코드 조회 + URL 조립 패턴(history_url_pattern 포함).", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/daily/today_{date}.json": {"get": {"summary": "날짜별 시장 다이제스트 아카이브", "description": "과거 그날의 today.json(30일 보관).", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}, "parameters": [{"name": "date", "in": "path", "required": true, "description": "발행일 YYYYMMDD. 보유 날짜는 index.json 의 daily_archive 참조", "schema": {"type": "string", "pattern": "^20[0-9]{6}$"}}]}}, "/data/public/notices.json": {"get": {"summary": "정정·공지 로그", "description": "파이프라인 실패·데이터 정정 이력(기계가독).", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}, "/data/public/excluded.json": {"get": {"summary": "발행 제외 종목", "description": "수집 제외 종목과 사유.", "responses": {"200": {"description": "성공", "content": {"application/json": {"schema": {"type": "object"}}}}, "404": {"description": "없는 종목코드/날짜"}}}}}}