auto-trade/common-docs/features/trade-stock-sync.md

Korean Stocks 동기화

korean-stocks.json은 수동 편집 파일이 아니라 자동 생성 파일입니다. 직접 수정하지 말고 동기화 스크립트로 갱신하세요.

실행 명령

npm run sync:stocks

• KIS 최신 KOSPI/KOSDAQ 마스터 파일을 내려받아 features/trade/data/korean-stocks.json을 다시 생성합니다.

npm run sync:stocks:check

• 현재 파일이 최신인지 검사합니다.
• 갱신이 필요하면 종료 코드 1로 끝납니다.

npm run sync:stocks -- --dry-run

• 원격 파일 파싱/검증만 하고 저장은 하지 않습니다.

권장 운영 방법

1. 하루 1회(또는 배포 전) npm run sync:stocks 실행
2. npm run lint, npm run build로 기본 검증
3. 갱신된 features/trade/data/korean-stocks.json 커밋

참고

• 데이터 출처:
  • https://new.real.download.dws.co.kr/common/master/kospi_code.mst.zip
  • https://new.real.download.dws.co.kr/common/master/kosdaq_code.mst.zip
• 비정상 데이터 저장을 막기 위해 최소 건수 검증(안전장치)을 넣었습니다.
• 임시 파일 저장 후 교체(원자적 저장) 방식이라 중간 손상 위험을 줄입니다.
• 공식 문서:
• https://apiportal.koreainvestment.com/apiservice-category