free-stockdb
SHA-256A주와 ETF를 대상으로 하는 로컬 퀀트 데이터 엔진, 증분 동기화, 39개 지표, 복권 및 5가지 호출 방식을 내장하고 있으며, 30분이면 전 시장 백테스트를 시작할 수 있습니다.
한 번의 클릭으로 A股 데이터 동기화, 로컬에서 즉시 지표 계산, 원격 API와 작별.
주요 기능
- 증분 동기화 및 중단점 재개: 변경된 데이터만 다운로드, Zstd 압축 지원, CSV/MySQL보다 3배 이상 디스크 공간 절약
- 내장 39가지 기술 지표 + 5가지 지수 계산: MA, MACD, KDJ, BOLL 등, Rust 코어 계산이 pandas보다 3배 빠름
- 다섯 가지 호출 방식: Python SDK, HTTP API, Excel/WPS 매크로, HTML 페이지, AI MCP (Claude, Cursor 지원)
- 완전한 수정주가 지원: 전수정, 후수정, 미수정, 내장 수정주가 계수
- 섹터 매핑: 내장 申万一二三级行业 + 1200+ 개념 섹터, 밀리초 단위 양방향 조회
할 수 없는 것
- •현재 Windows 버전(v0.2.1)만 제공되며, Mac 및 Linux 버전은 곧 출시될 예정입니다.
- •데이터 소스는 sync_url.txt를 통해 구성되며, 기본적으로 공용 노드를 사용하지만 내부 네트워크 또는 오프라인 파일로 전환할 수 있습니다.
- •리플리케이션 계수는 데이터 소스에서 제공되며, 가격과 거래량을 샘플링하여 예상대로 작동하는지 확인하는 것이 좋습니다.
- •서비스는 기본적으로 127.0.0.1:7899에서 수신 대기하며, 공용 네트워크에 능동적으로 노출되지 않지만 LAN 공유는 수동으로 활성화해야 합니다.
- •처음으로 분봉 데이터를 동기화하려면 약 20GB의 디스크 공간(전체 데이터 포함)이 필요하므로 충분한 공간을 확보하는 것이 좋습니다.
사용 사례
- 전체 시장 분 단위 백테스트: 원격 인터페이스를 기다릴 필요 없이 로컬에서 직접 7000개 이상의 주식 지표를 일괄 계산
- AI 퀀트 어시스턴트: MCP 프로토콜을 통해 Claude, Cursor 등 AI 도구가 로컬 시세를 직접 조회하고 기술 지표를 계산할 수 있게 합니다
상세 설명
free-stockdb는 A주 시장과 ETF를 위해 특별히 설계된 로컬 퀀트 데이터 엔진입니다. 증분 동기화, 자동 정제, 복권 처리, 39가지 기술 지표(이동평균선, MACD, KDJ 등) 및 5가지 지수 계산 방법을 통합하고 있으며, Python, HTTP, Excel/WPS, HTML 페이지, AI MCP의 다섯 가지 호출 방식을 제공합니다. 모든 데이터는 로컬에 저장되며 Zstd 압축을 사용하고, 오프라인 조회, 배치 계산 및 백테스트를 지원합니다. Tushare, AKShare 등 온라인 API가 전 시장 백테스트 환경을 구축하는 데 10~15영업일이 필요한 반면, free-stockdb는 30분 만에 사용 가능합니다. 퀀트 개발자, 금융 분석가, AI를 활용한 종목 선별을 원하는 사용자에게 적합합니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
Windows 배포 패키지를 다운로드하여 원하는 디렉토리에 압축 해제합니다.
데이터 업데이트 도구를 실행하고(update.exe 더블 클릭), ./data 폴더에 데이터가 동기화될 때까지 기다립니다.
stockdb 서비스를 시작합니다(stockdb.exe 더블 클릭, 용량 2.2MB에 불과).
- Windows 배포 패키지를 다운로드하여 원하는 디렉토리에 압축 해제합니다.
- 데이터 업데이트 도구를 실행하고(update.exe 더블 클릭), ./data 폴더에 데이터가 동기화될 때까지 기다립니다.
- stockdb 서비스를 시작합니다(stockdb.exe 더블 클릭, 용량 2.2MB에 불과).
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
ae34269354186c612e8678aa7bdeab0fcff58785ac11bb5259ec5b5b91cb2f16이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
압축 해제된 전체 폴더를 삭제하면 완전히 제거되며, 모든 로컬 데이터는 ./data에 유지됩니다 (정리가 필요하면 해당 폴더를 수동으로 삭제하십시오).
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.