42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# Korean Stocks 동기화
|
|
|
|
`korean-stocks.json`은 수동 편집 파일이 아니라 자동 생성 파일입니다.
|
|
직접 수정하지 말고 동기화 스크립트로 갱신하세요.
|
|
|
|
## 실행 명령
|
|
|
|
```bash
|
|
npm run sync:stocks
|
|
```
|
|
|
|
- KIS 최신 KOSPI/KOSDAQ 마스터 파일을 내려받아
|
|
`features/trade/data/korean-stocks.json`을 다시 생성합니다.
|
|
|
|
```bash
|
|
npm run sync:stocks:check
|
|
```
|
|
|
|
- 현재 파일이 최신인지 검사합니다.
|
|
- 갱신이 필요하면 종료 코드 `1`로 끝납니다.
|
|
|
|
```bash
|
|
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` |