Vnstock Logo

Giới thiệu Vnstock bản Mở rộng

Mở rộng

Mục lục

Tài liệu phiên bản trước: vnstock_data v3.2.9

Trang này viết cho phiên bản trước thế hệ 6 và được giữ để tra cứu. Phiên bản hiện hành là vnstock v6.0.1 — xem tài liệu v6.0.1 và hướng dẫn chuyển sang thế hệ 6.

Tài liệu này dành cho ai?

Dành cho người dùng gói quyền sử dụng đã tham gia gói quyền sử dụng Vnstock hoặc người dùng muốn so sánh tính năng giữa bản Cộng đồng (vnstock, phát hành theo giấy phép riêng, miễn phí cho cá nhân, học tập và nghiên cứu) và bản Mở rộng (vnstock_data) trước khi quyết định đăng ký gói.

Tổng quan so sánh

Tiêu chívnstockvnstock_data
LoạiGiấy phép riêng (bản Cộng đồng)Mã nguồn đóng (cấm sao chép, tái phân phối)
Mức phíMiễn phí cho cá nhân, học tập và nghiên cứuTham gia đóng góp qua Gói quyền sử dụng
Phân phốiCông khai qua PyPI và GithubTại website qua trình cài đặt riêng
Hạn mứcMột hạn mức chung mức cơ bản cho mọi thư viện, chia theo giờ, ngày, thángHạn mức chung lớn hơn theo cấp quyền sử dụng, dùng chung cho mọi thư viện
Yêu cầu đồng thờiNgười dùng tự kiểm soát; nên giữ mức đồng thời thấp và có khoảng nghỉThư viện gộp kết nối, dừng gọi khi nguồn từ chối và tạm ngừng khi nguồn không phản hồi
Dữ liệu trong phiênQua REST API, độ trễ tương đối khoảng 1-5 giây theo nguồnQua WebSocket, cập nhật theo độ trễ của nguồn
Phạm vi dữ liệuHạn chế: Xem chi tiếtĐầy đủ phạm vi dữ liệu nguồn trả về. Xem chi tiết
Mục đích sử dụngBộ hàm và API gọn hơn, phù hợp cho học tập, nghiên cứu, tra cứu nhanh, làm quen với lập trình và AI.Bộ hàm và API chuyên sâu hơn, phù hợp cho người dùng chuyên nghiệp và quy trình phân tích tự động chạy trên hạ tầng của bạn.

người dùng gói quyền sử dụng nhận quyền sử dụng phần mềm mở rộng có thời hạn, hạn mức cao hơn và mức ưu tiên hỗ trợ cao hơn. Vnstock không bán dữ liệu. Hạn mức là đơn vị kỹ thuật để giữ tải ở mức hợp lý với nguồn, không phải dữ liệu bán theo đơn vị.


So sánh tính năng chi tiết

1. Dữ liệu giá cổ phiếu

Chức năngvnstock (Bản Cộng đồng)vnstock_data (Bản Mở rộng)
Lịch sử giá OHLCVTối đa 8 năm (khung ngày) và 1 năm (khung phút)Truy cập toàn bộ dữ liệu từ khi cổ phiếu niêm yết
Giá khớp lệnh trong ngàyTối đa 30.000 bản ghi giao dịchToàn bộ bản ghi nguồn trả về cho phiên
Tải dữ liệu trong phiênSử dụng REST API - độ trễ thực tế ~1-5s trong phiên, theo nguồnSử dụng WebSocket nhận dữ liệu trong phiên theo độ trễ của nguồn, kết hợp thư viện vnstock_pipeline khi sử dụng gói quyền sử dụng Golden trở lên. Mặc định sẽ dùng REST API như bản Cộng đồng.

2. Dữ liệu tài chính & Doanh nghiệp

Chức năngvnstock (Bản Cộng đồng)vnstock_data (Bản Mở rộng)
Chỉ số tài chính & BCTCTối đa 8 kỳ (xác thực API key) hoặc 4 kỳ (chế độ khách)Toàn bộ số kỳ lịch sử nguồn trả về.
Thuyết minh báo cáo tài chínhKhông hỗ trợHỗ trợ trích xuất chi tiết thuyết minh BCTC
Tải báo cáo tài chính PDFKhông hỗ trợ tải file PDF scanHỗ trợ tải toàn bộ các loại báo cáo chính thức của doanh nghiệp. Tiện lợi khi ứng dụng tải về trích xuất dữ liệu bằng nhận dạng hình ảnh thông qua AI Agent, đặc biệt hữu ích cho phần diễn giải thuyết minh BCTC.
Chỉ tiêu sức khỏe tài chínhKhông hỗ trợĐầy đủ bộ tiêu chí chuẩn hoá để đánh giá nhanh sức khỏe tài chính của doanh nghiệp

3. Dữ liệu vĩ mô & Hàng hóa

Chức năngvnstock (Bản Cộng đồng)vnstock_data (Bản Mở rộng)
Chỉ số kinh tế vĩ môKhông hỗ trợThông số GDP, CPI, FDI, xuất nhập khẩu...
Tỷ giá & Lãi suất liên ngân hàngKhông hỗ trợCập nhật theo lịch công bố của nguồn
Giá hàng hóa thế giới & VNKhông hỗ trợGiá thép, dầu thô, nông sản, kim loại quý...

Giải đáp thắc mắc thường gặp

1. Đã đăng ký gói nhưng thư viện vẫn báo bản Cộng đồng

Đây là bối rối phổ biến nhất của người dùng gói quyền sử dụng sau khi tham gia gói quyền sử dụng. Mặc dù tài khoản của bạn đã được kích hoạt thành công trên hệ thống, bạn vẫn thấy thông báo sử dụng bản Community, và giới hạn số kỳ hay nhóm hàm chưa được mở rộng sang gói quyền sử dụng.

Nguyên nhân cốt lõi Bạn đang chạy code dựa trên thư viện vnstock bản Cộng đồng và thực hiện xác thực bằng hàm register_user().

Thư viện vnstock bản Cộng đồng không thể tự chuyển đổi sang tính năng của bản Mở rộng. Bản Mở rộng là một bộ thư viện độc lập cần cài đặt riêng nhưng hỗ trợ chuyển đổi code dễ dàng.

Cách xử lý

  1. Cài đặt thư viện bản Mở rộng: Bộ thư viện dành cho người dùng gói quyền sử dụng là các thư viện riêng (như vnstock_data, vnstock_ta, vnstock_pipeline), không thể cài đặt qua lệnh pip install vnstock_data thông thường. Bạn bắt buộc phải cài đặt thông qua trình cài đặt riêng tại trang Cài đặt bản Mở rộng.

  2. Thay đổi câu lệnh Import trong code: Sau khi cài đặt thành công, hãy cập nhật lại toàn bộ mã nguồn của bạn để import từ thư viện mới:

    • Cách cũ (Bản Cộng đồng):
      Python
      from vnstock import Quote, Listing
    • Cách mới (Bản Mở rộng):
      Python
      from vnstock_data import Market, Reference

Khi bạn import từ vnstock_data, thư viện sẽ tự động nhận diện API Key và áp dụng đúng cấp quyền sử dụng của bạn: mở thêm các nhóm hàm và áp dụng quỹ hạn mức sử dụng chung của cấp đó. Phần trăm hạn mức còn lại của giờ, ngày, tháng xem ở trang tài khoản hoặc qua lệnh vnstock usage (hệ thống tính theo hạn mức sử dụng chung, không quản lý theo lượt request).

2. Chuyển đổi mã nguồn từ Bản Cộng đồng sang Bản Mở rộng

Hầu hết các chức năng trên bản Mở rộng được thiết kế tương thích ngược với bản Cộng đồng giúp bạn dễ dàng chuyển đổi chỉ bằng cách đổi tên thư viện khi nạp lệnh.

Lưu ý về cấu trúc dữ liệu tài chính (nguồn VCI) Riêng đối với dữ liệu tài chính lấy từ nguồn VCI, cấu trúc bảng dữ liệu trả về giữa bản Cộng đồng và bản Mở rộng sẽ có sự khác biệt nhỏ về tên cột hoặc định dạng. Bạn cần lưu ý điều chỉnh lại các đoạn code xử lý bảng dữ liệu (DataFrame) sau khi chuyển đổi sang bản Mở rộng đối với nguồn này. Vnstock cung cấp sẵn Agent Skill hỗ trợ chuyển đổi code tự động tại Agent Guide.