Hướng sử dụng dẫn nhanh
Vnstock3 là tên gói phần mềm python thế hệ thứ 3 của dự án Vnstock. Vnstock sẽ dùng 1 tên gói phần mềm duy nhất kể từ 1/1/2025. Trong thời gian làm quen với phiên bản Vnstock3, trang tài liệu hướng dẫn của phiên bản phần mềm tiền nhiệm (gọi là legacy với các mã phiên bản 0.2.x.x) vẫn được duy trì tại địa chỉ docs.vnstock.site..
Sử dụng Vnstock3 với Google Colab
Để trải nghiệm các tính năng của Vnstock3, bạn cần có một môi trường sử dụng Python phù hợp. Cách dễ nhất để sử dụng mà không cần cài đặt phức tạp là mở file Notebook Demo dưới đây với dịch vụ Google Colab (miễn phí) và xem cách sử dụng theo minh hoạ. Bạn chỉ cần bấm các nút "Play" để chạy lệnh ở mỗi ô tương ứng, xem dữ liệu được trả về.
Để sử dụng Vnstock, bạn cần cài đặt thư viện trong ứng dụng Terminal trong môi trường Python hoặc 1 ô chứa mã Python trong giao diện Google Colab. Copy các dòng lệnh lần lượt như sau:
pip install vnstock3
Sau khi thư viện dã cài đặt, bạn tiếp tục sử dụng các câu lệnh như dưới đây:
from vnstock3 import Vnstock # Nạp thư viện để sử dụng
stock = Vnstock().stock(symbol='ACB', source='VCI') # Định nghĩa biến vnstock lưu thông tin mã chứng khoán & nguồn dữ liệu bạn sử dụng
# CÁC DÒNG LỆNH DƯỚI ĐÂY CÓ THỂ THAY THẾ CHO PHÙ HỢP, THAM KHẢO THÊM HÀM KHÁC
df = stock.quote.history(start='2024-01-01', end='2024-06-21', interval='1D') # Thiết lập thời gian tải dữ liệu và khung thời gian tra cứu là 1 ngày
print(df.head()) # Hiển thị 5 dòng dữ liệu đầu tiên
df.to_excel('gia_lich_su_ohlcv_ACB.xlsx', index=False) # Lưu file Excel
Chọn nút Demo Vnstock3 để xem tất cả các ví dụ lệnh minh hoạ, chọn Chi tiết sử dụng để xem cách gọi các hàm khác nhau của Vnstock cùng giải thích.
Bạn cũng có thể khám phá thêm những tính năng ẩn có trong mã nguồn nhưng chưa được cung cấp tài liệu hướng dẫn chi tiết. Dù bạn chọn cách nào, Vnstock tin bạn sẽ tìm được điều mình hứng thú.
Sử dụng phiên bản Vnstock tiền nhiệm 2.x.x
Để tiếp tục tra cứu tài liệu sử dụng phiên bản Vnstock trước 0.3.0 (từ nay sẽ đuược gọi là bản legacy), bạn có thể truy cập trang tài liệu tại đây. Cách thức tổ chức và sử dụng hàm của phiên bản legacy và phiên bản Vnstock3 có nhiều khác biệt. Bạn hãy đảm bảo mình đang xem đúng tài liệu hư ớng dẫn cho phiên bản mình sử dụng.