Vnstock thế hệ 5
Mục lục
Từ thế hệ 5, vnstock_data không còn là một thư viện riêng. Toàn bộ giao diện của nó nằm
trong thư viện vnstock 5.x, dùng chung cho mọi cấp tài khoản. Khoá cấp tài trợ của bạn
mở đủ các hàm và nguồn như ở bản Mở rộng.
Với phần lớn mã viết cho vnstock_data 3.x, việc cần làm là đổi dòng import:
# trước
from vnstock_data import Market, Reference, Fundamental, Macro, Insights, Analytics
# từ thế hệ 5
from vnstock import Market, Reference, Fundamental, Macro, Insights, AnalyticsTên lớp, tên nhóm (equity, index, futures…), tên hàm và tham số source= giữ
nguyên. Các lớp kiểu cũ (Quote, Listing, Company, Finance, Trading) và
vnstock.explorer.<nguồn> vẫn import được.
Bắt đầu
pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock
vnstock register # nhập khoá API cấp tài trợ
vnstock status # kiểm cấp và hạn dùngĐừng cài thế hệ 5 vào môi trường đang chạy vnstock_data: hai thế hệ cùng tên gói vnstock,
cài đè thì bản cũ hỏng và không trở lại như trước được. Nếu vnstock_data nằm trong ~/.venv
(chỗ trình cài 4.x dùng), cài thế hệ 5 vào ~/.venv5x để bản cũ giữ nguyên làm đường lui.
Chi tiết ở trang Cài đặt.
Đọc gì trước
| Trang | Vì sao |
|---|---|
| Chuyển từ vnstock_data 3.x | Những chỗ thế hệ 5 cố ý làm khác bản 3.x, tính năng đã ngừng, thời hạn của tên cũ |
| Đăng nhập và dòng lệnh | Lệnh vnstock thay cho cách đăng ký khoá của bản 3.x |
| Nguồn dữ liệu | Nguồn mặc định của từng hàm; một số nguồn mặc định đã đổi |
| Xử lý lỗi | Lỗi là ngoại lệ có kiểu mang mã code |
Các trang hàm (Reference, Market, Fundamental, Macro, Insights, Analytics,
quỹ mở) nằm trong mục lục bên trái, viết cho thế hệ 5 và dùng chung với không gian Cộng
đồng: một thư viện, một bộ tài liệu.
Ba chỗ hay vấp khi chạy mã cũ
ohlcv(length=N)trả N nến của khung đang hỏi;vnstock_datahiểu là N ngày. Muốn lấy theo ngày, viếtlength="30d"hoặc truyềnstart,end.- Lỗi là ngoại lệ có kiểu, không phải dòng chữ in ra rồi trả về
None. Mỗi ngoại lệ mang thuộc tínhcode;InputErrorcũng làValueError. - Một số tên có ngày ngừng và in
FutureWarningkèm tên mới:Market().pe(),pb(),evaluation(),vnstock.api.Market,vnstock.api.TopStocktới hết 31/12/2026; tên cũ của nhóm quỹ mở tới hết 06/04/2027.
Còn dùng vnstock_data 3.x
Bạn không phải chuyển ngay. Tài liệu vnstock_data 3.2.9 vẫn ở nguyên chỗ cũ: chọn phiên
bản ở ô cạnh tiêu đề trang để đổi qua lại.