프로젝트 소개

Vnstock은 베트남 금융시장 리서치를 위한 Python 생태계입니다. 클라이언트 측 커넥터로 작동하며, 사용자 환경에서 제3자 공개 또는 계정 기반 소스로 요청을 보내고 결과를 DataFrame으로 정규화하여 분석, 저장 또는 데이터 파이프라인에 사용합니다. 이 프로젝트는 시장 데이터 웨어하우스를 운영하여 재판매하지 않으며, 업스트림 데이터를 라이선스하거나 투자 조언을 제공하지 않는다고 명시합니다. 버전 4의 통합 인터페이스는 Market, Reference, Fundamental, Retail 도메인으로 기능을 구성합니다. 입증된 기능으로는 주식, 지수, ETF, 워런트, 선물, 외환, 상품 및 암호화폐에 대한 과거 OHLCV 데이터, 지연된 장중 호가 및 틱 단위 거래, 기업 프로필, 경영진, 주주, 자회사, 소유권, 내부자 거래, 자본 이력, 뉴스 및 이벤트, 심볼·산업·거래소 목록, 대차대조표, 손익계산서, 현금흐름표 및 재무 비율, 뮤추얼 펀드 보유 및 NAV 데이터, 소매 금 가격 및 환율이 포함됩니다. 데이터 범위는 선택한 소스에 따라 달라지며 변경될 수 있습니다. 패키지는 Vnstock의 패키지 인덱스에서 설치되며, 다른 종속성은 PyPI에서 가져옵니다. 게스트 액세스는 등록 없이 분당 20회 호출로 제한되며, 무료 등록 계정은 분당 60회, 스폰서 등급은 분당 180~600회 호출이 가능합니다. API 키는 대화형 등록 함수 또는 VNSTOCK_API_KEY 환경 변수를 통해 제공할 수 있습니다. 문서는 각 업스트림 소스의 이용 약관을 준수하고 분석, 거래 또는 게시 전에 공식 소스와 대조하여 검증할 것을 강조합니다. AI 어시스턴트 통합은 선택 사항이며 현재 버전에서는 기본적으로 비활성화되어 있습니다. 사용자는 Claude Code, Codex, Antigravity와 같은 도구를 위해 프로젝트 수준 또는 어시스턴트별 참조 파일을 명시적으로 생성할 수 있으며, 환경 변수로 동작을 구성하거나 비활성화할 수 있습니다. 프로젝트는 또한 초보자를 위한 Google Colab 및 AI 지원 코딩 가이드를 제공합니다. 소스는 개인, 교육 및 연구 목적으로 무료 사용을 허용하는 맞춤형 라이선스로 게시되지만 OSI 승인 오픈소스 라이선스는 아닙니다. 재배포 및 제3자 데이터 액세스를 주요 가치로 하는 제품 구축에는 별도의 서면 허가가 필요합니다.