{"schema_version": "1.1", "site": "한국주식데이터 (aikstockdata.com)", "generated_kst": "2026-08-03 16:15", "generated_at": "2026-08-03T16:15:00+09:00", "as_of": "2026.08.03", "published_date_iso": "2026-08-03", "quote_basis_date": "20260730", "quote_basis_date_iso": "2026-07-30", "license": {"name": "공공데이터(DART·금융위) 가공물 — 출처 표기 후 자유 이용(영리 포함)", "url": "https://aikstockdata.com/terms.html"}, "citation": "자료: 한국주식데이터(aikstockdata.com) — 원천: 금융감독원 DART · 금융위원회 공공데이터포털", "coverage": {"universe_n": 1500, "published_n": 1463, "excluded_n": 37, "note": "유니버스 1,500 중 정상수집 1,463, 제외 37(해당 거래일 시세 미수신 — 거래정지·정리매매·신규상장 미반영·상장폐지·코드불일치 등)", "stock_json_files": 1500}, "quality": {"transform_version": "p2.2026-07-17", "dataset": "public (FSC quotes + DART disclosures/financials)", "not_included_fields": ["PER", "PBR", "업종", "52주고저", "투자의견", "목표가", "실시간가"], "note": "위 필드는 공개 데이터에 의도적으로 미포함(증권사 파생·실시간 금지). null=미제공(0과 다름). 파이프라인 예외·정정 이력은 /data/public/notices.json 참조."}, "freshness": {"status": "fresh", "status_computed_at_kst": "2026-08-03 16:15", "quote_as_of_age_days": 4, "snapshot_id": "20260803-161530", "generated_at_kst": "2026-08-03 16:15", "quote_as_of": "20260730", "quote_as_of_iso": "2026-07-30", "disclosure_through": "20260803", "delayed_after": "2026-08-03", "stale_after": "2026-08-06", "next_update": "다음 거래일 18:10 KST", "note": "★status 와 quote_as_of_age_days 는 status_computed_at_kst 시점의 판정이다. 발행이 멈추면 이 값들이 낡아 실제보다 신선해 보인다 — **오늘 날짜로 직접 판정할 것**: 오늘 > stale_after 면 stale, 오늘 > delayed_after 면 delayed (기준: 시세 기준일 경과 fresh ≤4일 · delayed 5~7일 · stale 8일 이상). stale/delayed 면 답변에 데이터 지연을 먼저 밝힐 것. 파이프라인 건강은 별도 필드 pipeline 을 볼 것."}, "pipeline": {"last_success_kst": "20260803 10:32", "last_failure_date": "2026-07-31", "consecutive_failure_days": 0, "serving_last_good": false, "recent_failure_dates": ["2026-07-20", "2026-07-22", "2026-07-23", "2026-07-24", "2026-07-27", "2026-07-28", "2026-07-29", "2026-07-30", "2026-07-31"], "recovered_dates": [], "note": "데이터 신선도(freshness)와 파이프라인 건강은 별개다. 실행이 실패해도 직전 성공본을 계속 서빙하므로(last-good) 데이터가 한동안 fresh 로 남을 수 있다. serving_last_good=true 면 '오늘 것이 아니라 직전 성공본'이라는 뜻이다. published_at_kst 가 있으면 이번 발행이 검증 게이트를 모두 통과한 산출물이라는 뜻이다(그 값이 없으면 직전 성공본을 서빙 중일 수 있다). last_success_kst 는 이전 실행까지의 기록이라 이번 실행은 반영돼 있지 않다.", "published_at_kst": "2026-08-03 16:15", "gates_passed": ["sanity", "validate", "compliance"]}, "file_bytes": {"today.json": 7460, "quotes.json": 397463, "quotes_slim.json": 200612, "quotes_top300.json": 83503, "disclosures.json": 441453, "disclosures_top100.json": 80691, "rankings.json": 16019, "earnings.json": 215430, "search_index.json": 261645, "search_index_min.json": 82868, "excluded.json": 8705, "quotes.csv": 158500, "disclosures.csv": 170257}, "daily_archive": {"quotes_csv_pattern": "https://aikstockdata.com/data/public/daily/quotes_{YYYYMMDD}.csv", "disclosures_csv_pattern": "https://aikstockdata.com/data/public/daily/disclosures_{YYYYMMDD}.csv", "today_json_pattern": "https://aikstockdata.com/data/public/daily/today_{YYYYMMDD}.json", "available_dates": ["20260618", "20260619", "20260622", "20260623", "20260624", "20260625", "20260626", "20260629", "20260630", "20260701", "20260702", "20260703", "20260706", "20260707", "20260708", "20260709", "20260710", "20260713", "20260714", "20260715", "20260716", "20260720", "20260721", "20260722", "20260723", "20260724", "20260727", "20260728", "20260729", "20260730"], "quotes_available_dates": ["20260618", "20260619", "20260622", "20260623", "20260624", "20260625", "20260626", "20260629", "20260630", "20260701", "20260702", "20260703", "20260706", "20260707", "20260708", "20260709", "20260710", "20260713", "20260714", "20260715", "20260716", "20260720", "20260721", "20260722", "20260723", "20260724", "20260727", "20260728", "20260729", "20260730"], "disclosures_available_dates": ["20260721", "20260722", "20260723", "20260724", "20260727", "20260728", "20260729", "20260730", "20260731", "20260803"], "today_available_dates": ["20260731", "20260803"], "note": "패턴마다 보유 날짜가 다르다 — 시세 CSV=quotes_available_dates(구 available_dates), 공시 CSV=disclosures_available_dates(접수일 축), 시장요약 JSON=today_available_dates. 각 목록에 없는 날짜는 fetch 하지 말 것(최근 30영업일 보존)."}, "fetch_guide": {"problem": "대부분의 AI fetch 도구는 응답을 50~150KB 에서 자른다. 잘린 JSON 은 파싱 불가.", "rule": "file_bytes 를 먼저 보고 150000 이상이면 아래 소형 대체본을 쓸 것.", "small_alternatives": {"https://aikstockdata.com/data/public/disclosures.json": "https://aikstockdata.com/data/public/disclosures_top100.json", "https://aikstockdata.com/data/public/search_index.json": "https://aikstockdata.com/data/public/search_index_min.json", "https://aikstockdata.com/data/public/quotes.json": "https://aikstockdata.com/data/public/quotes_top300.json", "https://aikstockdata.com/data/public/quotes_slim.json": "https://aikstockdata.com/data/public/quotes_top300.json"}, "single_stock": "https://aikstockdata.com/data/public/s/{code6}.json (한 종목만 필요하면 항상 이것)"}, "schemas": ["https://aikstockdata.com/data/public/schemas/stock.schema.json", "https://aikstockdata.com/data/public/schemas/today.schema.json", "https://aikstockdata.com/data/public/schemas/quotes_slim.schema.json"], "transform_version": "p2.2026-07-17", "endpoints": [{"name": "오늘의 시장 다이제스트(하루 요약 — 등락·주요공시·성장·실적·집계)", "url": "https://aikstockdata.com/data/public/today.json", "format": "json", "schema": "schema.org/Dataset"}, {"name": "시세 전체(T+1 종가)", "url": "https://aikstockdata.com/data/public/quotes.json", "format": "json", "schema": "schema.org/Dataset"}, {"name": "시세 경량판(핵심 6필드 — 대용량 잘림 방지)", "url": "https://aikstockdata.com/data/public/quotes_slim.json", "format": "json"}, {"name": "시총 상위 300(내림차순 정렬 보장 — '시총 상위 N' 질문용)", "url": "https://aikstockdata.com/data/public/quotes_top300.json", "format": "json"}, {"name": "★종목 인덱스 경량판(코드·이름·시장 + URL 패턴 — 잘림 안전 72KB)", "url": "https://aikstockdata.com/data/public/search_index_min.json", "format": "json"}, {"name": "종목 인덱스(전 종목 code·이름·개별 JSON URL 리터럴 — 262KB, URL 조립 못 하는 환경용)", "url": "https://aikstockdata.com/data/public/search_index.json", "format": "json"}, {"name": "시세 CSV", "url": "https://aikstockdata.com/data/public/quotes.csv", "format": "csv"}, {"name": "시세 CSV(영문 헤더)", "url": "https://aikstockdata.com/data/public/quotes_en.csv", "format": "csv"}, {"name": "종목별 소형 JSON", "url_pattern": "https://aikstockdata.com/data/public/s/{code6}.json", "example": "https://aikstockdata.com/data/public/s/005930.json", "format": "json", "schema_version": "1.1"}, {"name": "★종목별 가격 시계열(1년 일별 종가·거래량 — 추세·고점대비 질문은 이 파일)", "url_pattern": "https://aikstockdata.com/data/public/s/{code6}_history.json", "example": "https://aikstockdata.com/data/public/s/005930_history.json", "format": "json", "schema_version": "1.0", "note": "행은 [date, close, volume] 배열(키 반복 제거로 경량화). 최대 250거래일. 휴장·무거래일은 행이 없으니 날짜 연속성을 가정하지 말 것."}, {"name": "★주요 공시 TOP100(중요도순 — 잘림 안전 64KB)", "url": "https://aikstockdata.com/data/public/disclosures_top100.json", "format": "json"}, {"name": "공시 브리핑 전체(쉬운 풀이·점수·재무원장 — 380KB)", "url": "https://aikstockdata.com/data/public/disclosures.json", "format": "json"}, {"name": "랭킹(성장·조용한 실적주·신고저)", "url": "https://aikstockdata.com/data/public/rankings.json", "format": "json"}, {"name": "어닝 스코어보드(실적 공시 롤링 120일 — rankings 에서 분리)", "url": "https://aikstockdata.com/data/public/earnings.json", "format": "json"}, {"name": "제외 종목 목록", "url": "https://aikstockdata.com/data/public/excluded.json", "format": "json"}, {"name": "정정·공지 로그(기계가독)", "url": "https://aikstockdata.com/data/public/notices.json", "format": "json"}, {"name": "종목 검색 인덱스(코드·이름·시장)", "url": "https://aikstockdata.com/data/public/search_index.json", "format": "json"}, {"name": "RSS 피드(공시·브리핑)", "url": "https://aikstockdata.com/feed.xml", "format": "rss"}, {"name": "llms.txt", "url": "https://aikstockdata.com/llms.txt", "format": "text"}, {"name": "데이터셋 안내(사람용)", "url": "https://aikstockdata.com/datasets.html", "format": "html"}], "notes": "시세는 전 영업일(T+1) 확정 종가로 실시간이 아닙니다. 전부 공공데이터(DART·금융위) 가공물이며, 업종·PER/PBR·52주 고저 등 증권사 파생 지표는 공개 데이터에 포함되지 않습니다."}