Lịch sử phiên bản

07-04-2026

Phát hành vnstock_data phiên bản 3.0.1 sửa các lỗi quan trọng và tinh chỉnh trải nghiệm người dùng.

• Unified UI: Bổ sung hàm cash_flow vào giao diện hợp nhất; cập nhật mô tả cho hàm trade_history (thống kê giao dịch, giá chứng khoán trước khi pha loãng).
• Nguồn KBS: Sửa lỗi chia điểm index cho 1000 và lỗi 502 Bad Gateway do web phân định lại cấu trúc URL; tinh chỉnh chuẩn hoá tên chỉ tiêu tài chính và thông tin định danh User Agent.
• Nguồn MBK (Vĩ mô): Cải thiện thuật toán truy xuất dữ liệu theo tham số length và tự động forward fill để khắc phục lỗi trả về dữ liệu rỗng.
• Nguồn SPL (Hàng hoá): Sửa lỗi truy xuất dữ liệu null sinh ra do không khớp cấu hình múi giờ.
• Nguồn VCI: Bổ sung cơ chế tương thích pandas cho hàm map và applymap để hoạt động tốt cho tất cả phiên bản từ 2.1.0 và trước đó.

03-04-2026

Phát hành vnstock_news 2.2.0: Công cụ truy xuất dữ liệu tin tức hiệu suất cao

Bản phát hành mới giải phóng bạn khỏi những lỗi xảy ra trong quá trình xử lý dữ liệu, mang tới sự ổn định khi trích xuất dữ liệu tin tức từ 21 trang tin nổi bật tại Việt Nam.

✨ Nâng cấp nổi bật

• Kiến trúc Crawler Hợp Nhất (Unified Crawler): Khai thác song song và tự động dự phòng chéo (fallback) giữa luồng RSS và Sitemap, đảm bảo hệ thống bạn luôn có tin mới khi một trong hai luồng gặp sự cố.
• Trích xuất metadata linh hoạt: Tăng cường khả năng bắt chính xác Selector qua các thuộc tính linh hoạt (id, data-slot, rel) thay vì phụ thuộc mỗi thẻ class theo CSS Selector truyền thống. Chủ động trích xuất thêm thẻ Tags, Lượt xem và Chuyên mục của bài.
• Làm sạch tự động & Xử lý thời gian:
  • Date Parser: Tự động "thấu hiểu" và ép kiểu mọi định dạng thời gian lạ lẻ (như 15 phút trước, Thứ năm...) về chuẩn ISO thống nhất cho Database.
  • Spam/Media Link Filter: Rà soát và loại bỏ link nhiễu phân trang, hình ảnh, URL rác đính kèm trong RSS.
  • Tự động bỏ qua lỗi chứng chỉ SSL để duy trì kết nối cho những tòa soạn chưa nâng cấp máy chủ hiện đại.

🐛 Vận hành trơn tru hơn

• Sửa dứt điểm tình trạng trả về Data nhưng cột Nội dung trống rỗng (Missing Content 100%) gây ra bởi lỗi đọc JSON.
• Bổ sung đầu báo mới được hỗ trợ: Bổ sung và tinh chỉnh cấu trúc CSS cho hàng loạt trang báo mới (Tiền Phong, Người Lao Động, Thanh Niên, Znews, Dân Trí, Đầu Tư, VnEconomy).
• Bổ sung bộ kịch bản dùng thử "All-in-one" và tái cấu trúc tài liệu ví dụ, tự động dọn dẹp kết quả xuất file vào phân vùng tĩnh /output/.

11-03-2026

Phát hành vnstock_data 3.0.0: Thế hệ mới với Unified UI và Thị trường Quốc tế.

Phiên bản 3.0.0 không chỉ là một bản cập nhật thông thường, mà là bước chuyển mình quan trọng của hệ sinh thái Vnstock. Chúng tôi mang đến kiến trúc 7 lớp tiêu chuẩn nghiệp vụvà trải nghiệm lập trình (DX) được nâng cấp vượt trội.

• Kiến trúc 7 Lớp & Unified UI (U2):

  • Hoàn thiện mô hình Unified UI với 7 phân vùng chức năng rõ rệt: Reference, Market, Fundamental, Analytics, Alternative, Macro, và Insights.
  • Cách tiếp cận "Vấn đề là trên hết": Bạn không còn phải lo lắng về việc dữ liệu đến từ đâu, chỉ cần tập trung vào việc bạn muốn làm gì (định giá, xem bảng giá hay tra cứu thông tin cơ bản). Chất lượng và nguồn dữ liệu tốt nhất sẽ được Vnstock khuyến nghị. Bạn có thể cá nhân hoá nguồn dữ liệu như cách lập trình cũ nếu muốn để khai thác các chức năng có sẵn nhưng ẩn sâu trong mã nguồn.
  • Bổ sung thông tin hồ sơ (profile) chi tiết cho Chứng quyền và Hợp đồng tương lai, giúp bạn nắm bắt đầy đủ thông tin sản phẩm trước khi giao dịch.
  • Tích hợp Lịch sự kiện thị trường toàn diện: từ dữ liệu lịch sử (nghỉ lễ, sự cố thị trường... từ năm 2000) đến các sự kiện hiện tại và tương lai giúp bạn bao quát toàn cảnh thị trường một cách chuyên sâu.

• Trợ lý lập trình thông minh (Next-Gen DX):

  • Tái kích hoạt tính năng Autocomplete và Docstring vượt trội trên các IDE (VSCode, PyCharm), giúp việc viết code nhanh và ít lỗi hơn.
  • Bổ sung bộ công cụ khám phá API: show_api() để vẽ sơ đồ thư viện ngay trong terminal và show_doc() để đọc nhanh hướng dẫn sử dụng cho từng hàm.
  • Tài liệu (Docstrings) đã được chuyển đổi sang tiếng Anh chuẩn để dễ dàng tiếp cận và phù hợp với tiêu chuẩn lập trình hiện đại và tương tác với AI Agent.

• Chuẩn hóa & Tối ưu hóa hệ thống:

  • Chuẩn hoá dữ liệu bảng giá từ nguồn KBS: Giải quyết triệt để các vấn đề về hiển thị lô chẵn, lô lẻ; đồng bộ hóa dữ liệu cho đa dạng loại tài sản từ cổ phiếu, phái sinh, chứng quyền đến trái phiếu.
  • Dữ liệu được tự động chuẩn hóa (Normalization) từ nhiều nguồn khác nhau về một định dạng duy nhất, giúp việc tính toán và phân tích nhất quán hơn.
  • Cơ chế Lọc tham số (Kwargs Filtering): Giúp giảm thiểu lỗi runtime khi bạn vô tình truyền thừa tham số, tăng tính ổn định cho chương trình.
  • Tối ưu hóa tốc độ tải dữ liệu và cấu trúc nội bộ để sẵn sàng cho các bài toán phân tích dữ liệu lớn.

• Cập nhật Vnstock Agent Guide: Tài liệu hướng dẫn chi tiết và các quy tắc cho AI Agent trong lập trình tự động được cập nhật qua Agent Guide tại đây

05-03-2026

• Cập nhật module Unified UI (U2): Cập nhật các lớp UI cung cấp cấu trúc lệnh hợp nhất với phân nhóm chặt chẽ lấy cảm hứng từ chuẩn FIX và Bloomberg Terminal giúp điều hướng dễ dàng theo mặc định do Vnstock thiết kế và người dùng không cần cài đặt nguồn dữ liệu. Tài liệu hướng dẫn chi tiết được cập nhật qua Agent Guide tại đây

• Bổ sung hàm lấy thông tin Chứng quyền và hợp đồng tương lai:

  • Cung cấp hàm trong giao diện U2 để lấy thông tin chứng quyền và hợp đồng tương lai thông qua Reference().derivatives().warrant() và Reference().derivatives().futures()

• Bổ sung hàm lấy thông tin bộ lọc cổ phiếu từ VCI thông qua U2 tại Insights().screener()

• Cải thiện & bổ sung API nguồn Vĩ mô:

  • Bổ sung method interest_rate để lấy dữ liệu Lãi suất bình quân & Doanh số trên thị trường liên ngân hàng. Hỗ trợ tham số format='pivot' (mặc định) để trả về bảng dạng nhóm cột (MultiIndex giống biểu diễn trên website) hoặc format='long' để trả về định dạng phẳng (raw format).
  • Tích hợp thêm tham số khoảng thời gian tương đối length (ví dụ: 90, 1Y, 30D, 100b) tương tự như cách sử dụng trong quote.history. Tính năng này áp dụng đồng bộ cho tất cả các hàm vĩ mô (gdp, cpi, interest_rate, exchange_rate v.v...) để bỏ qua việc nhập ngày bắt đầu start và kết thúc end.
  • Thay đổi thời gian lấy dữ liệu mặc định (khi không cung cấp start, end, hoặc length) là 1 năm (1Y) để trả về thông tin ở khoảng thời gian phù hợp và nhẹ.
  • Tài liệu hướng dẫn chi tiết được cập nhật qua Agent Guide tại đây

• Cải thiện trải nghiệm sử dụng module lấy dữ liệu hàng hoá:

  • Tích hợp khả năng lấy thời gian tương đối thông qua tham số length tương tự như module macro và quote.history.
  • Thay đổi thời gian lấy dữ liệu mặc định (khi không cung cấp start, end, hoặc length) về 1 năm (1Y) thay vì lấy toàn bộ lịch sử như trước đây.
  • Tài liệu hướng dẫn chi tiết được cập nhật qua Agent Guide tại đây

31-01-2026

Phát hành phiên bản 2.3.4, sửa lỗi và cải thiện trải nghiệm người dùng

• Chuẩn hoá định dạng dữ liệu giá thành dạng thập phân xx.xx (ngàn) thay vì xxxx (đồng) cho các hàm history và intraday trong lớp Quote của nguồn dữ liệu KBS.
• Sửa lỗi không cho phép gọi tham số length trong hàm history của lớp Quote của nguồn dữ liệu VCI, VND, MAS khi không truyền tham số start và end.
• Sửa lỗi không nhận diện nguồn VND cho lớp hàm Market
• Cập nhật chương trình cài đặt vnstock installer chế độ GUI và CLI sử dụng uv là công cụ quản lý gói thư viện thay cho pip, tăng tốc độ cài đặt và giảm 30% thời gian hoàn thành.

28-01-2026

Phát hành phiên bản 2.3.2, sửa lỗi và cải thiện trải nghiệm người dùng

• Chuẩn hoá tham số period để lấy dữ liệu báo cáo tài chính cho các phương thức trong lớp Finance của nguồn dữ liệu KBS - cho phép gọi tham số này khi khởi tạo lớp Finance thay vì gọi ở mỗi phương thức.
• Bổ sung tham số length cho phép lấy dữ liệu hàng hoá theo cách tính thời gian tương đối so với hiện tại thay vì bắt buộc nhập ngày bắt đầu và kết thúc.
• Tinh chỉnh nhỏ cho lớp Commodity giúp nạp thư viện chính xác, loại bỏ lỗi liên quan nested f-string sinh ra trong quá trình bảo mật mã nguồn.

27-01-2026

Phát hành phiên bản 2.3.1, bổ sung tài liệu hướng dẫn chi tiết Vnstock Agent Guide.

• Bổ sung hàm tiện ích convert_derivative_symbol giúp chuyển đổi mã hợp đồng tương lai kiểu cũ (VN30F1M) sang kiểu mới sau áp dụng KRX (tương đương 41I1G2000 tại thời điểm tháng 1/2026)

• Cải thiện nguồn KBS

  • Sửa lỗi không nhận diện nguồn dữ liệu KBS từ Finance wrapper
  • Bổ sung khả năng lấy dữ liệu báo cáo tài chính nhiều năm thay vì cố định 4 năm như phiên bản trước
  • Tự động nhận diện và chuyển đổi mã hợp đồng tương lai sang kiểu mới để gọi các hàm history và intraday trong lớp hàm Quote.
  • Bổ sung khả năng lấy dữ liệu các mã index phổ biến HNXINDEX, HNXINDEX, UPCOMINDEX, VN30, VN100, HNX30 trong hàm history của lớp Quote.

• Cải thiện chung

  • Hiện cảnh báo mã index không có dữ liệu intraday.

23-01-2026

• Phát hành phiên bản 2.2.0, bổ sung nguồn dữ liệu KBS cho phép truy cập từ các dịch vụ cloud của Google như Google Colab, Kaggle thay vì nguồn VCI bị chặn IP.
• Bổ sung khả năng truy xuất thông tin các bộ chỉ số đầu tư và chỉ số ngành từ HOSE vào Listing class, truy cập được từ mọi giá trị source.
• Cập nhật yêu cầu phiên bản gói phụ thuộc tương thích.

31-08-2025

Phát hành phiên bản Vnstock News 2.1.0 nâng cấp toàn diện cơ chế tải dữ liệu và cung cấp khả năng tuỳ biến linh hoạt, bổ sung tài liệu hướng dẫn chi tiết.

Để cài đặt bản cập nhật, vui lòng chạy lại chương trình cài đặt của Vnstock tại đây.

• Thay đổi hoàn toàn cấu trúc chương trình theo hướng chặt chẽ và module hoá
• Cung cấp cơ chế tự xử lý link sitemap và rss linh hoạt đối với các website sử dụng cơ chế động ví dụ sitemap theo năm-tháng, sitemap với số đếm tăng dần.
• Hỗ trợ đầy đủ 10 trang web có sẵn trong danh sách định nghĩa sẵn, người dùng có thể tự bổ sung thêm cấu hình để dùng vnstock_news như một chương trình crawler đọc tin tức hàng loạt.

29-08-2025

Phát hành phiên bản Vnstock Pipeline 2.0.1 nâng cấp cơ chế tải dữ liệu Intraday và Streaming dữ liệu thời gian thực.

Để cài đặt bản cập nhật, vui lòng chạy lại chương trình cài đặt của Vnstock tại đây.

• Bổ sung tài liệu hướng dẫn tuỳ biến chương trình
• Cải thiện trải nghiệm sử dụng: tuỳ chọn địa điểm lưu file khi streaming, lọc dữ liệu mong muốn thay vì tự lưu toàn bộ.
• Cải thiện khả năng truy cập dữ liệu intraday liên tục trong phiên giao dịch và ghép nối thông minh hơn.
• Bổ sung tính năng Data Manager cho phép quản lý cấu trúc dữ liệu lưu trữ khoa học và chặt chẽ
• Bổ sung khả năng lưu trữ dữ liệu định dạng parquet, nén dữ liệu ~75% so với CSV và tăng hiệu năng xử lý.

21-07-2025

Phát hành phiên bản Vnstock Data 2.1.3 và nâng cấp cơ chế quản lý license chính xác hơn.

Để thực hiện nâng cấp phiên bản, các bạn vui lòng chạy lại chương trình cài đặt, lưu ý nên chạy thử và trải nghiệm qua môi trường như Github Codespace để hình dung các thay đổi để không làm ảnh hưởng đến chương trình hiện có. Hệ thống không thể quay lại phiên bản cú sau nâng cấp.

Ads Free

Ẩn banner quảng cáo đối với người dùng đang duy trì gói sponsor trừ những thông báo đặc biệt liên quan đến trải nghiệm người dùng hoặc yêu cầu nâng cấp bắt buộc.

Vnstock Data Explorer

• Bổ sung nguồn Fmarket vào mã nguồn
• Bổ sung và nâng cấp các API của nguồn VCI
  • Thay thế API các nhóm hàm Quote, Listing class gặp lỗi từ chối truy cập và đổi url
  • Bổ sung bộ API mới cho nhóm hàm thuộc Financial class
    • Cập nhật API mới
    • Cho phép sử dụng tiếp API cũ từ máy tính local nếu muốn.
  • Sửa đổi nhóm hàm Trading cho phép lấy dữ liệu phân tích lịch sử giao dịch & bảng giá
    • Thêm các hàm foreign_trade để lấy riêng thông tin giao dịch nước ngoài
    • Loại bỏ các hàm trading_stats và side_stats trong nhóm hàm thuộc Trading class để không trùng thông tin với hàm price_board

02-06-2025

Vnstock Data Explorer

Chi tiết hàm bổ sung tại Nguồn VCI - Thống kê giao dịch

06-05-2024

Vnstock Data Explorer

• Issue 164: Cập nhật tính năng thay đổi user_agent ngẫu nhiên không sử dụng gói fake_user_agent
• Issue 172: Bổ sung hàm price_board cho Trading class thuộc nguồn dữ liệu VCI
• Issue 178 và sửa lỗi dữ liệu Intraday sau cập nhật hệ thống KRX cho nguồn VCI và MAS.
• Đóng Issue 169 vì dữ liệu khung thời gian 1W đã được hỗ trợ sẵn trong thư viện.
• Issue 166 Cập nhật thiết lập rate limit cho các nguồn dữ liệu trong gói tài trợ, tránh hiển thị nhầm thông báo nâng cấp.

22-04-2025

Vnstock Data Explorer

Phiên bản vnstock_data 2.1.0 đánh dấu bước tiến lớn trong khả năng quản lý và mở rộng dữ liệu, với việc áp dụng cấu trúc Adapter chuẩn hóa toàn bộ giao tiếp với nguồn cấp dữ liệu.

✨ Những Thay Đổi Quan Trọng

🚨 Lưu Ý Ảnh Hưởng Đến Đoạn Mã Cũ

Nếu bạn đang sử dụng vnstock_data theo cách cũ

from vnstock_data import Trading
trading = Trading(symbol='MSN')
quote.history(start="2024-01-01", end="2024-04-01")

➡️ Từ phiên bản 2.1.0, đoạn code trên sẽ lỗi nếu thông tin source không trùng khớp với nguồn cấp dữ liệu hỗ trợ. Cụ thể, bạn cần sửa lại thành:

from vnstock_data import Trading
quote = Quote(source="cafef", symbol="VCI")
quote.history(start="2024-01-01", end="2025-04-18", interval="1D")