Sobre el proyecto

Vnstock es un ecosistema de Python para la investigación del mercado financiero de Vietnam. Funciona como un conector del lado del cliente: las solicitudes se envían desde el entorno del propio usuario a fuentes públicas o basadas en cuentas de terceros, y los resultados se normalizan en DataFrames para análisis, almacenamiento o canalizaciones de datos. El proyecto declara que no opera un almacén de datos de mercado para reventa, no licencia datos de proveedores ni proporciona asesoramiento de inversión. La interfaz unificada de la versión 4 organiza la funcionalidad en dominios de Mercado, Referencia, Fundamentos y Minorista. Las capacidades evidenciadas incluyen datos históricos OHLCV para acciones, índices, ETF, warrants, futuros, divisas, materias primas y criptomonedas; cotizaciones retrasadas en sesión y operaciones tick a tick; perfiles de empresas, liderazgo, accionistas, subsidiarias, propiedad, transacciones de información privilegiada, historial de capital, noticias y eventos; listados de símbolos, industrias y bolsas; balances, estados de resultados, flujos de caja y ratios financieros; tenencias de fondos mutuos y datos de NAV; además de precios minoristas de oro y tipos de cambio. La cobertura de datos depende de la fuente seleccionada y puede cambiar. El paquete se instala desde el índice de paquetes de Vnstock, mientras que otras dependencias provienen de PyPI. El acceso de invitado está limitado a 20 llamadas por minuto sin registro, las cuentas gratuitas registradas a 60 llamadas por minuto, y los niveles de patrocinador a 180–600 llamadas por minuto. Las claves API se pueden proporcionar mediante una función de registro interactivo o la variable de entorno VNSTOCK_API_KEY. La documentación enfatiza el cumplimiento de los términos de cada fuente upstream y la verificación contra fuentes oficiales antes de análisis, negociación o publicación. La integración con asistentes de IA es opcional y está deshabilitada por defecto en las versiones actuales. Los usuarios pueden generar explícitamente archivos de referencia a nivel de proyecto o específicos del asistente para herramientas como Claude Code, Codex y Antigravity; las variables de entorno pueden configurar o deshabilitar el comportamiento. El proyecto también proporciona guías de Google Colab y codificación asistida por IA para principiantes. Su código fuente se publica bajo una licencia personalizada que permite uso personal, educativo y de investigación sin cargo, pero no es una licencia de código abierto aprobada por OSI; la redistribución y la creación de un producto cuyo valor principal sea el acceso a datos de terceros requieren permiso escrito por separado.