# thinh-vu/vnstock

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

Repository: https://github.com/thinh-vu/vnstock
Canonical: https://ross.abutalabs.com/products/vnstock
Homepage: https://vnstocks.com
Language: Python
License: NOASSERTION
License Family: other
Topics: stock-market, data-extraction, stock-screener, quantitative-finance, quantitative-analysis, quantitative-trading
Last push: 2026-07-24T10:59:32+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 94, release rhythm 80, longevity 100
- inputs: {"age_days": 1648, "days_push": 40, "days_rel": 55, "gap_med": 49, "n_releases_24m": 8}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1383, forks 294 (observed 2026-08-28T04:04:34.551019+00:00)

## What it is
Vnstock is an open-source Python library for extracting and analyzing Vietnam stock market data, returning data as pandas DataFrames via simple function calls. It aggregates fragmented data sources into a unified API and is designed to work well with AI agents and 'vibe coding' workflows.

## Use cases
- download historical stock prices for Vietnamese tickers
- build quantitative trading models on Vietnam market data
- screen Vietnamese stocks by fundamental criteria
- automate portfolio analysis in Python
- feed Vietnam market data into AI agents or notebooks
- scrape stock data without writing custom scrapers

## When to choose
- you need Vietnam-specific stock market data in Python
- you want DataFrame-ready financial data without building scrapers
- you are a retail investor or quant researcher focused on the Vietnamese market
- you want a beginner-friendly API usable from Google Colab

## When to avoid
- you need data for markets outside Vietnam
- your project requires a permissive open-source license (it uses a custom non-commercial license)
- you need guaranteed commercial-grade data SLAs
- you need real-time trading execution rather than data extraction

## Facets
- artifact type: library
- maturity: active
- function: data-science, etl, web-scraping, sdk, analytics
- domain: fintech, data-science, analytics
- platform: python, cross-platform
- tags: vietnam-stock-market, financial-data, stock-screener, quantitative-finance, pandas-dataframe, non-standard-license, automation

## Member repositories
- thinh-vu/vnstock (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:34.551019+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:40:04.355085+00:00, confidence not recorded.
  - readme: https://github.com/thinh-vu/vnstock (fetched 2026-08-28T04:04:34.551019+00:00, sha 47a81e30abec)
  - homepage: https://vnstocks.com (fetched 2026-08-29T11:56:00.414843+00:00, sha a215bcac89cd)
  - site_page: https://vnstocks.com/docs (fetched 2026-08-29T11:56:00.417947+00:00, sha 69d9d41ef32a)
  - site_page: https://vnstocks.com/about (fetched 2026-08-29T11:56:00.420019+00:00, sha 7714c3b91ff0)
  - registry_pypi: https://pypi.org/pypi/vnstock/json (fetched 2026-08-29T11:56:00.422158+00:00, sha 167d4040e2bd)
- Data as of 2026-08-30T08:39:29.467469+00:00.