Lịch sử phiên bản
Cập nhật lần cuối:
Thảo luậnMục lục
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
historyvàintradaytrong 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
historycủa lớp Quote của nguồn dữ liệu VCI, VND, MAS khi không truyền tham sốstartvà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
uvlà công cụ quản lý gói thư viện thay chopip, 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ố
lengthcho 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_symbolgiú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
historyvàintradaytrong 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
historycủa lớp Quote.
-
Cải thiện chung
- Hiện cảnh báo mã index không có dữ liệu
intraday.
- Hiện cảnh báo mã index không có dữ liệu
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_statsvàside_statstrong nhóm hàm thuộc Trading class để không trùng thông tin với hàmprice_board
- Thêm các hàm
02-06-2025
Vnstock Data Explorer
Cập nhật phiên bản 2.1.2
Chi tiết hàm bổ sung tại Nguồn VCI - Thống kê giao dịch
06-05-2024
Vnstock Data Explorer
Cập nhật phiên bản 2.1.1
- 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_boardcho 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_data2.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
| Hạng mục | Thay đổi |
|---|---|
| Cấu trúc thư viện | Triển khai mô hình Adapter Pattern cho tất cả các lớp dữ liệu (Quote, Trading, Finance, Listing, Company, Macro, Commodity, v.v.). |
| Cách gọi hàm | Các hàm khi sử dụng Adapter cần truyền tham số source để xác định rõ nhà cung cấp dữ liệu mong muốn. |
Mặc định source | Tham số source không còn mặc định ngầm định như phiên bản trước. Nếu không truyền source đúng, hàm có thể gây lỗi NotSupportedError. |
| Hướng dẫn chi tiết hơn | Bổ sung bảng tra cứu phương thức hỗ trợ theo nguồn cấp dữ liệu, và sơ đồ hệ thống trực quan. |
🚨 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")
Thảo luận