vnstock
A beginner-friendly yet powerful Python toolkit for financial analysis and automation — built to make modern investing accessible to everyone
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- 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.
- Low friction: pure Python wheel, 13 runtime dependencies (requests, pandas, beautifulsoup4, seaborn, openpyxl, pydantic, and others) are all stable and widely available.
License · maintenance · safety
non-commercial license (noncommercial) — 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.
last release 2026-07-24 (21 days) · last repo commit 2026-07-24 · 1,373 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 103,773 downloads/mo, #12,786 on PyPI
Alternatives
Verify before relying
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')- 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.
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 on this page. Verify before relying on it.
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
vnstock on PyPI
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.
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.
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')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 | non-commercial license noncommercial |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 13 packagesrequestsbeautifulsoup4pandasseabornopenpyxlpydanticpsutilpackagingimportlib-metadatatenacityvnaivnstock_ezchartpytz |
| Maintenance | Actively maintained 21 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 103,773 / month, #12,786 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: Financial and Insurance IndustryLicense :: Other/Proprietary LicenseNatural Language :: EnglishNatural Language :: VietnameseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Office/Business :: Financial :: InvestmentTopic :: Software Development :: Libraries |
Evidence: vnstock-4.0.5-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “vnindex historical prices”
- vnstockVnstock fetches Vietnamese stock market data—historical prices,…
- forex-pythonFetches current and historical foreign exchange rates and Bitcoin…
- yfinanceFetches financial and market data from Yahoo Finance's public APIs,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also pyvi · vnai · vnstock-ezchart · pykrx · lseg-data · yahooquery · baostock · tushare · tradingeconomics · sea-g2p