Giới thiệu vnstock
Mục lục
Dành cho người mới dùng vnstock — bản cộng đồng, công khai mã nguồn theo giấy phép riêng. Trang này nói rõ bản miễn phí làm được gì, dừng ở đâu, và nên đọc tiếp trang nào. Nếu bạn đang dùng bộ thư viện mở rộng, xem Giới thiệu vnstock_data.
vnstock là thư viện Python để truy vấn và chuẩn hoá dữ liệu thị trường tài chính
Việt Nam. Thư viện chạy trên máy hoặc máy chủ do bạn kiểm soát: nó gửi truy vấn từ
runtime của bạn tới nguồn bạn chọn, rồi trả về dữ liệu đã chuẩn hoá dưới dạng
DataFrame của pandas.
Kể từ phiên bản 4.0, thư viện dùng kiến trúc Unified UI: một giao diện lập trình duy nhất cho mọi nhóm dữ liệu và mọi nguồn cấp.
Đặc tính của bản miễn phí
| Tiêu chí | Bản cộng đồng vnstock |
|---|---|
| Giấy phép | Công khai mã nguồn theo giấy phép riêng |
| Mức phí | Miễn phí |
| Phân phối | PyPI và GitHub |
| Hạn mức | Tối đa 60 yêu cầu mỗi phút khi dùng khoá API tạo trên website |
| Dữ liệu trong phiên | Qua REST API, độ trễ khoảng 1–5 giây tuỳ nguồn |
| Lịch sử giá | Tối đa 8 năm khung ngày, 1 năm khung phút |
| Giao dịch trong ngày | Tối đa 30.000 bản ghi |
| Báo cáo tài chính | Tối đa 8 kỳ khi xác thực khoá API, 4 kỳ ở chế độ khách |
| Tải song song | Bạn tự cấu hình |
Bảng đối chiếu đầy đủ từng hàm giữa hai bản nằm ở So sánh Bản cộng đồng và Bản tài trợ.
Học tập, nghiên cứu, tra cứu nhanh và làm quen với lập trình dữ liệu tài chính. Nếu bạn cần chạy phân tích thường xuyên trên khối lượng lớn, cần dữ liệu trong phiên độ trễ thấp, hoặc cần lịch sử dài hơn giới hạn ở bảng trên, hãy đọc phần so sánh trước khi quyết định.
Cài đặt
pip install -U vnstockMuốn chạy thử ngay trên trình duyệt mà không cài gì, xem Chạy thử trên Colab. Muốn dựng môi trường Python đàng hoàng trên máy, xem Cài Python cho người mới.
Bốn nhóm dữ liệu
Unified UI chia dữ liệu theo nghiệp vụ, mỗi nhóm một trang tài liệu riêng:
| Nhóm | Nội dung | Tài liệu |
|---|---|---|
| Reference | Thông tin tham chiếu về doanh nghiệp, cổ phiếu, chỉ số | Dữ liệu tham chiếu |
| Market | Giá lịch sử, khớp lệnh, bảng giá | Dữ liệu thị trường |
| Fundamental | Báo cáo tài chính và chỉ số định giá | Phân tích cơ bản |
| Retail | Vàng, ngoại tệ và hàng hoá bán lẻ | Thị trường hàng hoá |
Đọc tiếp
- Kiến trúc thư viện — ba lớp của Unified UI và ba cách gọi lệnh tương ứng.
- Biểu diễn dữ liệu — vẽ biểu đồ từ bảng dữ liệu vừa lấy về.
- Tự động nạp Agent Skills và tài liệu — để trợ lý AI viết mã Vnstock đúng ngay từ đầu.
- Lịch sử phiên bản — thay đổi qua từng bản phát hành.
Thảo luận