Об этом проекте

Vnstock — это экосистема Python для исследования финансового рынка Вьетнама. Она работает как клиентский коннектор: запросы отправляются из среды самого пользователя к сторонним публичным источникам или источникам на основе аккаунта, а результаты нормализуются в DataFrame для анализа, хранения или конвейеров данных. Проект заявляет, что не управляет хранилищем рыночных данных для перепродажи, не лицензирует вышестоящие данные и не предоставляет инвестиционные консультации. Унифицированный интерфейс версии 4 организует функциональность в домены Market, Reference, Fundamental и Retail. Подтверждённые возможности включают исторические данные OHLCV для акций, индексов, ETF, варрантов, фьючерсов, форекс, сырьевых товаров и криптовалют; котировки с задержкой в течение сессии и сделки тик за тиком; профили компаний, руководство, акционеров, дочерние компании, структуру собственности, инсайдерские сделки, историю капитала, новости и события; списки символов, отраслей и бирж; балансовые отчёты, отчёты о прибылях и убытках, отчёты о движении денежных средств и финансовые коэффициенты; данные о владениях паевых фондов и NAV; а также розничные цены на золото и обменные курсы. Охват данных зависит от выбранного источника и может меняться. Пакет устанавливается из индекса пакетов Vnstock, а другие зависимости — из PyPI. Гостевой доступ ограничен 20 вызовами в минуту без регистрации, бесплатные зарегистрированные аккаунты — 60 вызовами в минуту, а спонсорские уровни — 180–600 вызовами в минуту. Ключи API можно передавать через интерактивную функцию регистрации или переменную среды VNSTOCK_API_KEY. Документация подчёркивает соблюдение условий каждого вышестоящего источника и проверку по официальным источникам перед анализом, торговлей или публикацией. Интеграция с AI-ассистентами необязательна и по умолчанию отключена в текущих версиях. Пользователи могут явно генерировать справочные файлы уровня проекта или конкретного ассистента для таких инструментов, как Claude Code, Codex и Antigravity; переменные среды позволяют настраивать или отключать это поведение. Проект также предоставляет руководства по Google Colab и программированию с помощью ИИ для начинающих. Его исходный код опубликован под пользовательской лицензией, которая разрешает бесплатное личное, образовательное и исследовательское использование, но не является одобренной OSI лицензией с открытым исходным кодом; распространение и создание продукта, основная ценность которого заключается в доступе к сторонним данным, требуют отдельного письменного разрешения.