{"version":"v1","endpoints":{"GET /api/v1/signals":"기준일의 목록 구성원 (signal 생략 시 목록별 건수)","GET /api/v1/signals/{signal}/stats":"그 시그널의 과거 성과 (window=all|recent60)","GET /api/v1/stock/{code}/signals":"종목이 걸린 시그널 이력 (from, to)","GET /api/v1/patterns":"차트 패턴 전수 정산 성적표 — 모집단 전체 (pattern, timeframe)","GET /api/v1/regime":"지금 어떤 규칙이 통하는 장인가 (as_of, window)","GET /api/v1/market":"기준일의 지수·시장 폭·밸류에이션·매크로"},"signals":[{"signal":"value-surge","label":"거래대금 급증","group":"이례 시그널","has_stats":true,"status":"active"},{"signal":"value-top","label":"거래대금 상위","group":"순위","has_stats":true,"status":"active"},{"signal":"gainers","label":"상승률 상위","group":"순위","has_stats":true,"status":"active"},{"signal":"losers","label":"하락률 상위","group":"순위","has_stats":true,"status":"active"},{"signal":"high-52w","label":"52주 신고가","group":"이례 시그널","has_stats":true,"status":"active"},{"signal":"low-52w","label":"52주 신저가","group":"이례 시그널","has_stats":true,"status":"active"},{"signal":"market-cap","label":"시가총액 상위","group":"순위","has_stats":true,"status":"active"},{"signal":"large-gainers","label":"대형주 상승률 상위","group":"순위","has_stats":true,"status":"active"},{"signal":"turnover","label":"회전율 상위","group":"순위","has_stats":true,"status":"active"},{"signal":"gap-up","label":"갭 상승","group":"이례 시그널","has_stats":true,"status":"active"},{"signal":"streak-up","label":"연속 상승","group":"이례 시그널","has_stats":true,"status":"active"},{"signal":"low-per","label":"저PER","group":"팩터","has_stats":true,"status":"active"},{"signal":"momentum-12-1","label":"12-1 모멘텀 상위","group":"팩터","has_stats":true,"status":"active"},{"signal":"momentum-weighted","label":"가중 모멘텀 상위","group":"팩터","has_stats":true,"status":"active"},{"signal":"drawdown-52w","label":"52주 고점 대비 낙폭 상위","group":"팩터","has_stats":true,"status":"active"},{"signal":"surge-pullback","label":"급증 뒤 되돌림","group":"반전 후보","has_stats":true,"status":"active"},{"signal":"turnover-gapdown","label":"과열 뒤 갭하락","group":"반전 후보","has_stats":true,"status":"active"},{"signal":"low52-surge","label":"신저가 부근 거래대금 급증","group":"반전 후보","has_stats":true,"status":"active"},{"signal":"high-dividend","label":"고배당","group":"팩터","has_stats":true,"status":"active"},{"signal":"disparity-hot","label":"20일선 과열","group":"반전 후보","has_stats":true,"status":"active"},{"signal":"disparity-cold","label":"20일선 과냉","group":"반전 후보","has_stats":true,"status":"active"},{"signal":"golden-cross","label":"골든크로스","group":"차트 이론","has_stats":true,"status":"active"},{"signal":"ma-stack","label":"정배열 진입","group":"차트 이론","has_stats":true,"status":"active"},{"signal":"box-breakout","label":"박스권 상단 돌파","group":"차트 이론","has_stats":true,"status":"active"},{"signal":"trend-breakout","label":"추세 돌파","group":"차트 이론","has_stats":true,"status":"active"},{"signal":"rsi-oversold","label":"RSI 과매도","group":"차트 이론","has_stats":true,"status":"active"},{"signal":"golden-cross-flow","label":"골든크로스 + 외국인·기관 순매수","group":"차트 × 수급","has_stats":true,"status":"active"},{"signal":"ma-stack-flow","label":"정배열 진입 + 외국인·기관 순매수","group":"차트 × 수급","has_stats":true,"status":"active"},{"signal":"dry-surge","label":"조용하다 돈이 몰린","group":"반전 후보","has_stats":true,"status":"active"},{"signal":"foreign-buy-streak","label":"외국인 연속 순매수","group":"수급","has_stats":true,"status":"active"},{"signal":"accumulation","label":"안 올랐는데 계속 산","group":"수급","has_stats":true,"status":"active"},{"signal":"distribution","label":"올랐는데 계속 판","group":"수급","has_stats":true,"status":"active"},{"signal":"both-buy","label":"기관·외국인 동반 순매수","group":"수급","has_stats":true,"status":"active"},{"signal":"retail-only","label":"개인만 받는","group":"수급","has_stats":true,"status":"active"},{"signal":"short-surge","label":"공매도 비중 급증","group":"수급","has_stats":true,"status":"active"},{"signal":"short-top","label":"공매도 비중 상위","group":"수급","has_stats":true,"status":"active"}],"retired_signals":[{"signal":"program-buy","status":"retired","label":"프로그램 순매수","retired_on":"2026-09-25","reason":"종목별 프로그램매매 이력을 2026-06 이전으로 채울 길이 없어 목록에서 내렸다"}],"flags":[{"code":"liquidation","label":"정리매매","note":"가격제한폭이 없다 — 등락률을 다른 종목과 같은 자에 놓을 수 없다"},{"code":"delisting","label":"상장폐지 예정","note":"상장폐지 절차가 진행 중이다 — 아직 제한폭 안에서 거래된다"},{"code":"halted","label":"거래정지","note":"거래소가 막았다 — 정지 공시의 최신 상태가 정지이고 그날 거래량도 0인 종목"},{"code":"no_trade","label":"무거래","note":"그날 한 주도 거래되지 않았다 — 정지일 수도 있고 유동성이 없을 수도 있다"}],"records":{"GET /api/v1/published":"그날 실제로 내건 목록(발행 기록) — 발행 뒤 수정되지 않는다 (signal, from, to, cursor)","GET /api/v1/published.csv":"발행 기록 CSV 일괄 받기 (signal)","GET /api/v1/status":"기준일 · 속보/확정 · 목록별 마지막 발행 시각 · 다음 갱신 — 폴링 전에 이것부터","POST /api/v1/keys":"무료 API 키 발급(선택) — {\"email\": ...}. 키를 X-API-Key 헤더로 보내면 분당 한도가 오른다","GET /api/v1/stock/{code}/flow":"외국인·기관·개인 순매수(금액·수량) · 공매도 비중 — 없는 날 null (from, to)","GET /api/v1/macro":"매크로 계열 목록 — 환율·금리·외국인 보유 비중·신용융자·예탁금·주택가격·가계부채 (최신값·주기·시작일)","GET /api/v1/macro/{series}":"한 계열의 시계열 (from, to) — 월·분기 계열은 그 기간 마지막 날에 찍힌다"},"conditional_get":"모든 GET 응답에 ETag. If-None-Match 로 보내면 바뀌지 않았을 때 304","rate_limit_per_min":60,"rate_limit_per_min_with_key":300,"bulk_limit_per_day":400,"closed":{"GET /api/v1/stock/{code}/ohlcv":"일봉 원시세 — 원천 약관(재배포 금지)"},"docs":"/api","openapi":"/api/v1/openapi.json","meta":{"as_of":"2026-10-29T01:28:08+09:00","data_date":null,"lag_business_days":null,"next_update":null,"source":"공공데이터포털 금융위원회 시세 · 한국은행 ECOS · 금융감독원 DART · 한국거래소 통계정보","license":"출처: 각 원천 · 원천 데이터의 이용 조건은 원천 약관을 따릅니다","disclaimer":"전일 마감 데이터이며 투자 참고용입니다. 특정 종목의 매수·매도를 권유하지 않습니다.","commercial":"내 PC 에서 내 한국투자증권·공공데이터포털 키로 이 API 와 같은 기준의 백테스트를 돌리는 도구를 무료 비공개 베타로 드립니다. 본인 키·계좌로만 쓸 수 있습니다. 받으려면 쓰실 용도를 적어 contact@maedong.kr 로 보내 주세요. 한도를 늘리는 문의도 같은 주소로 받습니다. 시세·수급 원자료는 각 원천 약관을 따릅니다."}}