Phát hành Vnstock 3.2.1 – Tái cấu trúc thư viện & bổ sung bộ lọc cổ phiếu mới

Bạn có thể dễ dàng cập nhật ngay bằng câu lệnh pip¹ trong Terminal:

pip install -U vnstock

Hãy cùng điểm qua các nâng cấp mới trong phiên bản này.

🚀 Tính năng mới nổi bật trong Vnstock v3.2.1

Bộ lọc cổ phiếu nâng cao từ TCBS quay trở lại

Tính năng bộ lọc cổ phiếu từ các phiên bản cũ đã được tích hợp lại trong phiên bản Vnstock v3.2.1. Bạn có thể trích xuất các tiêu chí lọc cổ phiếu cho toàn bộ mã niêm yết trên thị trường.

Điểm nổi bật:

• Cú pháp đơn giản, chỉ cần chỉ định sàn giao dịch và số lượng kết quả.

• Hỗ trợ lọc sâu và phân loại chi tiết sau khi có bảng tổng hợp.

• Tiết kiệm thời gian xử lý và phân tích mã cổ phiếu.

Thêm dữ liệu thông tin doanh nghiệp từ nguồn VCI

Bạn có thể truy xuất thông tin công ty niêm yết từ nguồn dữ liệu của VCI², bên cạnh nguồn hiện tại từ TCBS³:

• Tăng tính linh hoạt và đa dạng cho nguồn thông tin doanh nghiệp.

• Giúp so sánh và đối chiếu thông tin giữa các nguồn dữ liệu khác nhau.

Kết nối Google Drive – Lưu trữ kết quả phân tích

Tính năng kết nối Google Drive (cần xác nhận cấp quyền từ người dùng) giúp lưu trữ dữ liệu phân tích trực tiếp sau mỗi phiên làm việc:

• Lưu trữ file dữ liệu trên tài khoản Drive cá nhân.

• Tiện lợi khi chạy các đoạn code phân tích Vnstock trên Google Colab⁴.

• Thuận tiện lưu trữ và quản lý phiên bản các kết quả phân tích.

⚙️ Cải tiến trải nghiệm người dùng

Phiên bản này mang đến một số điều chỉnh giúp quá trình viết mã và xử lý lỗi dễ dàng hơn:

• Nhận diện trạng thái phiên: Gửi cảnh báo chi tiết khi người dùng gọi dữ liệu intraday⁵ hoặc price_depth⁶ ngoài giờ giao dịch.

• Cảnh báo giới hạn truy vấn: Hiển thị cảnh báo trực quan khi vượt giới hạn tần suất gọi API⁷ để bạn chủ động điều tiết tiến trình chạy code.

• Đồng nhất tên gọi: Chuẩn hóa tên cột (như chuyển ticker thành symbol, HOSE thành HSX⁸) giúp dữ liệu đồng bộ trên toàn bộ thư viện.

• Cập nhật cấu hình kết nối: Sửa lỗi kết nối đối với các endpoint lấy dữ liệu để đảm bảo hoạt động liên tục.

🛠️ Tái cấu trúc mã nguồn

Phiên bản v3.2.1 tập trung cải tổ cấu trúc code bên trong nhằm tối ưu hóa khả năng vận hành lâu dài:

• Tăng tính mô-đun hóa: Tách biệt các thành phần xử lý dữ liệu và thiết lập hàm tái sử dụng tốt hơn.

• Cấu trúc tinh gọn: Giúp mã nguồn dễ bảo trì, tạo tiền đề để tích hợp các tính năng mới nhanh chóng hơn.

• Chuẩn hóa xử lý ngoại lệ: Thư viện trả về lỗi (raise error) cụ thể thay vì chỉ ghi log, giúp lập trình viên dễ kiểm soát luồng chạy của chương trình.

📚 Hệ thống tài liệu hỗ trợ

Bộ tài liệu hướng dẫn được thiết kế để hỗ trợ tốt nhất cho lập trình viên ở các nhu cầu khác nhau:

• Ba cấp độ tài liệu của Vnstock:

  • Các bài viết blog chia sẻ tình huống thực tế và ví dụ mẫu.

  • Trang tài liệu tham chiếu (API Reference) chi tiết từng hàm và tham số.

  • File mô tả kỹ thuật trên GitHub⁹ được tối ưu để các công cụ AI hỗ trợ sinh mã nguồn nhanh và chính xác hơn.

Với các thành viên tham gia gói tài trợ và học viên, Vnstock GPT¹⁰ sẽ là trợ lý AI hữu ích giúp tạo nhanh mã nguồn dựa trên cấu trúc mới nhất.

🚩 Cập nhật phiên bản mới

Bạn có thể nâng cấp lên phiên bản Vnstock v3.2.1 bằng câu lệnh pip¹:

pip install -U vnstock

👉 Xem thêm thông tin chi tiết các hàm tại tài liệu hướng dẫn và các bài viết trên blog để cập nhật các hướng dẫn mới nhất.

Chúng tôi rất mong nhận được các ý kiến phản hồi đóng góp từ cộng đồng để tiếp tục hoàn thiện thư viện.