Phát hành Vnstock 4.0: Một giao diện API, tích hợp mọi nhu cầu

Chào các bạn,

Hôm nay là một ngày đặc biệt. Ngày 28/4/2026, chúng ta không chỉ đón chào một phiên bản mới, mà là sự ra đời của Vnstock Thế hệ 4.0. Con số 4.0 không chỉ mang ý nghĩa thứ tự phiên bản, mà nó còn đại diện cho tinh thần của cuộc cách mạng công nghiệp 4.0 — nơi AI và dữ liệu chuẩn hóa trở thành "mạch máu" cho mọi quyết định đầu tư.

Cách đây 4 năm, khi đặt những dòng code đầu tiên cho Vnstock, mình đơn giản chỉ là một "kẻ ngoại đạo" muốn tìm cách lấy dữ liệu chứng khoán nhanh hơn Excel và có thể lặp lại bước nạp dữ liệu một cách hiệu quả. Mình đã từng loay hoay hàng giờ, từng gặp lỗi mà không biết hỏi ai. Chính sự đồng cảm đó đã nuôi dưỡng Vnstock lớn mạnh như hôm nay.

Hành Trình Phát Triển: Từ "Jupyter Notebook" Đến "Giao Diện API Hợp Nhất"

Nhìn lại chặng đường đã qua, Vnstock đã trải qua 4 giai đoạn tiến hóa rõ rệt:

Giai đoạn 1 (2022): Simple Standalone Functions — Những hàm đơn lẻ, thô sơ nhưng giải quyết đúng nỗi đau "tải dữ liệu" của người dùng.
Giai đoạn 2 (2023): Vnstock Class — Cấu trúc hóa các hàm vào một lớp duy nhất, giúp việc gọi lệnh trở nên chuyên nghiệp và dễ quản lý hơn.
Giai đoạn 3 (2024): API Classes — Đơn giản hoá cách thức sử dụng với các lớp API chuyên biệt (Listing, Quote, Finance...), đáp ứng nhu cầu dữ liệu đa dạng.
Giai đoạn 4 (2026): Unified UI — Vnstock 4.0 ra đời với Giao diện người dùng hợp nhất (Unified UI). Giờ đây, bạn không cần quan tâm đến thiết lập nguồn dữ liệu khi thao tác, Vnstock sẽ tự động điều phối và chuẩn hóa theo các tiêu chuẩn quốc tế lấy cảm hứng từ FIX và Bloomberg Terminal.

Những Con Số "Biết Nói"

Mình thực sự ấn tượng khi kiểm tra thống kê số lượt tải thư viện tại PyPI:

~500.000+ lượt tải chỉ trong 30 ngày vừa qua.
Một đợt tăng trưởng đột biến chưa từng có. Bởi nếu bạn theo dõi dự án thì phải mất ~4 năm để thư viện đạt tổng số lượt download 800K.
Chính thức vượt mốc 1,2 triệu lượt download toàn thời gian.

Những con số này là minh chứng cho sự tin tưởng của các bạn, nhưng đồng thời cũng là áp lực dần hiện hữu lên hạ tầng thư viện và những lo ngại về sự ảnh hưởng tới các nguồn cấp dữ liệu nếu không có biện pháp vận hành nghiêm ngặt.

Có Gì Mới Trong Vnstock 4.0?

Phiên bản này tập trung vào việc "Chuẩn hóa" và "hỗ trợ AI Agent" mạnh mẽ hơn nữa:

Giao diện Hợp nhất (Unified UI): Cung cấp toàn cảnh các tính năng truy xuất dữ liệu trong một điểm chạm duy nhất. Thư viện sẽ tự động chọn nguồn cấp ổn định nhất (ngầm định), giúp trải nghiệm người dùng không bị gián đoạn.
Chuẩn hóa Quốc tế: Các phương pháp đặt tên và tham chiếu được áp dụng theo chuẩn quốc tế, giúp các AI Agent dễ dàng hiểu và thực thi lệnh mà không cần bạn phải can thiệp quá nhiều khi môi trường đã được thiết lập các thư mục tài liệu và skill cần thiết từ Vnstock Agent Guide.
Khắc phục sự cố nguồn cấp: Nâng cấp phương thức kết nối cho các nguồn như VCI (Listing, Company, Finance) và KBS, đảm bảo dòng chảy dữ liệu luôn thông suốt.


Shell
# Nâng cấp ngay lên phiên bản 4.0
pip install -U vnstock

Giao diện API hợp nhất có gì?

Vnstock chuẩn hoá toàn bộ cửa ngõ truy cập API về một giao diện duy nhất mang tên Unified UI, bạn có thể hiển thị cấu trúc cây API này thông qua hàm show_api từ thư viện vnstock và xem chi tiết mô tả từng chức năng qua hàm show_docs.


Shell
API STRUCTURE TREE - VNSTOCK (Unified UI)
vnstock
├── Reference
│   ├── company # Access company-specific reference data.
│   │   ├── info() [KBS] -> DataFrame # Get company overview.
│   │   ├── shareholders() [KBS] -> DataFrame # List major shareholders.
│   │   ├── officers() [KBS] -> DataFrame # List company leadership.
│   │   ├── subsidiaries() [KBS] -> DataFrame # List subsidiaries.
│   │   ├── ownership() [KBS] -> DataFrame # Company ownership structure.
│   │   ├── insider_trading() [KBS] -> DataFrame # Insider trading history.
│   │   ├── capital_history() [KBS] -> DataFrame # Capital change history.
│   │   ├── news() [KBS] -> DataFrame # Company related news.
│   │   └── events() [KBS] -> DataFrame # Upcoming corporate events.
│   ├── equity # Equity symbols and grouping reference.
│   │   ├── list() [KBS] -> DataFrame # List all equity symbols.
│   │   ├── list_by_group() [KBS] -> DataFrame # List equities by group.
│   │   ├── list_by_industry() [VCI] -> DataFrame # List equities by industry.
│   │   └── list_by_exchange() [KBS] -> DataFrame # List symbols by exchange/board.
│   ├── index # Market index reference data.
│   │   ├── list() [KBS] -> DataFrame # List all market indices.
│   │   ├── members() [KBS] -> DataFrame # List constituents of an index.
│   │   ├── groups() [KBS] -> DataFrame # List supported index groups.
│... # And many more
├── Market
│   ├── quote() [KBS] -> DataFrame # Global real-time quote.
│   ├── equity # Access equity market data.
│   │   ├── ohlcv() [KBS] -> DataFrame # Historical OHLCV bars.
│   │   ├── quote() [KBS] -> DataFrame # Real-time pricing board data.
│   │   └── trades() [KBS] -> DataFrame # Tick-by-tick trade tape.
│   ├── index # Access index market data.
│   │   └── ohlcv() [KBS] -> DataFrame # Historical OHLCV bars for indices.
│....  # And many more
├── Fundamental
│   └── equity # Access equity fundamental data.
│   │   ├── balance_sheet() [KBS] -> DataFrame # Get balance sheet.
│   │   ├── cash_flow() [KBS] -> DataFrame # Get cash flow.
│   │   ├── income_statement() [KBS] -> DataFrame # Get income statement.
│   │   └── ratios() [KBS] -> DataFrame # Financial ratios.
├── Retail
│   ├── gold() # Access gold price data.
│   └── exchange_rate() # Access exchange rate data.

Tầm Nhìn & Trách Nhiệm: "Chiếc Modem" Kết Nối Dữ Liệu

Mình luôn coi Vnstock giống như một "chiếc Modem Wifi". Bạn có smartphone (mô hình AI), bạn có nhu cầu lướt web (phân tích đầu tư), và Vnstock là thiết bị kết nối. Việc "mạng có nhanh không" phụ thuộc vào nhà mạng (các nguồn dữ liệu nguồn), nhưng Vnstock cam kết sẽ luôn là chiếc modem ổn định nhất có thể.

Định hướng mới: Personal & Research Public Limited Để bảo vệ hệ sinh thái chung, Vnstock 4.0 sẽ áp dụng các giới hạn nhất định nhằm hạn chế việc sử dụng vô ý, quá mức gây ảnh hưởng đến cộng đồng và các nguồn cấp. Đây là một "rào cản tự nhiên" cần thiết để duy trì sự cộng sinh bền vững giữa người dùng và các nguồn dữ liệu công khai.

Đánh Giá Độ Ổn Định & Chuẩn Hóa

Để bạn có cái nhìn thực tế nhất khi xây dựng hệ thống, mình phân loại độ ổn định của dữ liệu dựa trên kinh nghiệm vận hành thực tế:

Nhóm dữ liệu	Độ ổn định	Đặc điểm
Thị trường (PTKT)	Rất ổn định	Schema chuẩn hóa tốt, dễ chuyển đổi và ít biến động kỹ thuật.
Tham chiếu (Niêm yết, công ty)	Trung bình - Cao	Ít thay đổi nếu tập trung vào bộ tiêu chí cốt lõi.
Tài chính (BCTC, Chỉ số)	Trung bình	Khó chuẩn hóa schema nhất, nguồn dữ liệu không đồng nhất và nhiều tiêu chí thay đổi theo thời gian.

Vnstock Dành Cho Ai?

Vnstock được thiết kế và tối ưu cho những nhóm người dùng sau:

Nhà đầu tư cá nhân & chuyên gia tài chính am hiểu công nghệ: Những người muốn tự chủ trong việc phân tích và ra quyết định dựa trên dữ liệu thay vì cảm tính với sự hỗ trợ của AI Agent.
Sinh viên & nghiên cứu viên: Vnstock được sử dụng rộng rãi tại các trường Đại học để làm nguồn dữ liệu đầu vào miễn phí và dễ tiếp cận cho các đồ án, luận văn, khóa luận tốt nghiệp hoặc nghiên cứu khoa học.
Builder & Data Scientists: Những người cần xây dựng nguyên mẫu (prototype) hoặc hệ thống thử nghiệm với chi phí tối thiểu và tài liệu đầy đủ.
Startup & Team nhỏ: Những đơn vị cần giải pháp dữ liệu linh hoạt, dễ tích hợp để nhanh chóng đưa ý tưởng vào thực tế trong khung thời gian từ 6 tháng đến 2 năm.

Điều Khoản Sử Dụng & Miễn Trừ Trách Nhiệm

Dù Vnstock 4.0 là một bước tiến lớn về công nghệ, người dùng cần lưu ý và chấp thuận các điều khoản sau để đảm bảo sử dụng thư viện đúng mục đích và an toàn:

Về nguồn dữ liệu & Sự gián đoạn: Vnstock là một công cụ kết nối dữ liệu trung gian, không trực tiếp lưu trữ hay sở hữu dữ liệu. Độ ổn định và tính chính xác phụ thuộc hoàn toàn vào các nguồn cấp công khai (bên thứ ba). Chúng tôi không cam kết duy trì kết nối liên tục và sẽ nỗ lực khắc phục các sự cố kỹ thuật phát sinh trong vòng 1 tuần (bản Sponsor) hoặc 10 - 14 ngày (bản Cộng đồng) kể từ khi tiếp nhận phản hồi trừ những trường hợp bất khả kháng (có thông báo nguyên do).
Cơ chế "Hậu kiểm": Dữ liệu được Vnstock tái tạo với mục tiêu phản ánh sát nhất các giá trị hiển thị trên giao diện phân tích của nguồn cấp. Do đặc thù dữ liệu tài chính, chúng tôi khuyến khích cộng đồng tích cực phản hồi để cải thiện độ chính xác, thay vì coi đây là nguồn dữ liệu chuẩn tuyệt đối không sai sót.
Miễn trừ trách nhiệm pháp lý: Vnstock được cung cấp "nguyên trạng" (AS IS) chỉ dành cho mục đích nghiên cứu học thuật và tham khảo cá nhân. Tác giả và dự án hoàn toàn miễn trừ trách nhiệm đối với bất kỳ tổn thất tài chính, rủi ro pháp lý hoặc thiệt hại gián tiếp nào phát sinh từ việc sử dụng dữ liệu do thư viện cung cấp để thực hiện các quyết định đầu tư. Người dùng tự chịu trách nhiệm 100% trong việc kiểm tra, đối soát và xác thực dữ liệu trước khi thực hiện bất kỳ giao dịch tài chính nào.
Yêu cầu về năng lực người dùng: Việc sử dụng thư viện đòi hỏi người dùng có kiến thức căn bản về lập trình Python và am hiểu nghiệp vụ tài chính. Vnstock không chịu trách nhiệm cho các sai sót phát sinh từ việc thiếu hụt kiến thức chuyên môn hoặc sử dụng công cụ sai mục đích.

Một Hành Trình Mới

Vnstock 4.0 không chỉ là một công cụ hay bộ mã nguồn. Đó là sự lắng đọng của cả một hành trình 4 năm miệt mài. Mình đã quyết định bỏ qua phiên bản 3.5.2 như dự kiến để tiến thẳng lên 4.0, như một lời khẳng định về sự thay đổi toàn diện trong tư duy thiết kế.

Nếu bạn là một "builder", một nhà đầu tư yêu thích dữ liệu, hay đơn giản là một người muốn khám phá sức mạnh của AI trong tài chính, chào mừng bạn đến với thế hệ mới của Vnstock.

Hãy nâng cấp ngay hôm nay và cùng mình kiến tạo tương lai của lập trình tài chính tại Việt Nam!

Thịnh Vũ

Tác giả Vnstock