---
id: vnstock
version: "4.0.5"
license: Custom: Personal, research, non-commercial; contact support@vnstocks.com for other use
license_treatment: noncommercial
maintenance: active
---

# vnstock — A beginner-friendly yet powerful Python toolkit for financial analysis and automation — built to make modern investing accessible to everyone

License: noncommercial · Maintenance: active · Downloads: 103.8K/mo

## What it is and what it does

Vnstock is a Python library that automates extraction of Vietnamese stock market data through a unified API. It provides access to equity prices (OHLCV), financial statements, company profiles, market indices, derivatives, ETFs, and macroeconomic indicators—all returned as pandas DataFrames ready for analysis or export. The library abstracts away the complexity of scraping fragmented Vietnamese market data sources, letting you focus on building quantitative models, integrating analysis platforms, or exploring historical price trends.

The package is designed for individual investors and developers who want programmatic access to Vietnamese market data without writing custom scrapers. It supports modern Python versions (3.10+), integrates with pandas and seaborn for analysis and visualization, and is built to work with AI agents and "vibe coding" workflows. Rate limiting is enforced (20–600 requests per minute depending on registration tier), and authentication is optional for basic use but recommended for higher throughput.

Use it for:

- Fetch historical OHLCV data for a Vietnamese stock symbol to backtest a trading strategy or calculate technical indicators.
- Retrieve company financial statements (balance sheet, income statement) to build a fundamental analysis dashboard.
- List all equities in a specific industry or exchange board to screen for investment opportunities.
- Export market index constituents and their real-time quotes for portfolio tracking or rebalancing.
- Integrate Vietnamese market data into a quantitative research pipeline or AI-driven analysis workflow.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Vnstock fetches Vietnamese stock market data—historical prices, financial statements, company profiles, indices, and macroeconomic indicators—via a unified Python API and returns it as pandas DataFrames.

Yes—if your use case is personal research, education, or non-commercial analysis of Vietnamese markets. The library has low install friction, active maintenance, no known vulnerabilities, and a large API surface covering equities, indices, fundamentals, and macroeconomic data. However, verify the custom noncommercial license against your intended use; commercial applications require explicit permission. Rate limiting and API key registration may be necessary for production workloads.

## Install

pip install vnstock
uv add vnstock
poetry add vnstock

## Installing vnstock

Before you install: Low friction: pure Python wheel, 13 runtime dependencies (requests, pandas, beautifulsoup4, seaborn, openpyxl, pydantic, and others) are all stable and widely available. Active maintenance—last commit 2026-07-24, 1373 GitHub stars, released 21 days ago.

License in practice: Custom noncommercial license: free for personal research and non-commercial use; commercial applications require contacting support@vnstocks.com. Verify your intended use case against the license terms before deploying.

Quickstart:

pip install -U vnstock

from vnstock import Market, Reference

market = Market()
df_history = market.equity.ohlcv(symbol='VNM', start='2024-01-01', end='2024-05-01')

ref = Reference()
df_profile = ref.company.info(symbol='FPT')

Requires Python >=3.10. API calls are rate-limited: 20 requests/minute as guest, 60 requests/minute with free registration, higher tiers available via sponsorship.

Verify before relying:

- Whether the 1.2 million lifetime downloads claim is current as of the fact sheet date.
- Data freshness guarantees and real-time vs. delayed pricing for equity quotes.
- Availability and completeness of historical data for all supported symbols and date ranges.
- Whether vnai and vnstock_ezchart dependencies are optional or required for core functionality.

## Package facts

- License: Custom: Personal, research, non-commercial; contact support@vnstocks.com for other use (noncommercial)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 103.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vietnamese stock market data, vnindex historical prices, vietnam equity ohlcv, financial data api vietnam, stock analysis vietnam python, company fundamentals vietnam, market data extraction vietnam, finance-data, vietnam-markets, quantitative-analysis

[View on SkillFed](https://skillfed.io/packages/vnstock) · [View on PyPI](https://pypi.org/project/vnstock/)