Giới thiệu
Mục lục
Trang này viết cho vnstock_quant v1.0.0rc1, bản thử nghiệm. Tên hàm, tham số và cột dữ liệu có thể còn đổi trước ngày phát hành; khi cài, ghi rõ số phiên bản như ở trang Cài đặt. Bản đang phát hành chính thức là v0.5.0, xem tài liệu bản đó.
Đây là bản thử nghiệm đầu tiên của vnstock_quant cho thế hệ 6, đi cùng vnstock 6.0.0rc3 và vnstock-oapi 0.1.0rc2. Bản thử nghiệm dùng được 30 ngày kể từ ngày dựng; khi gần hết hạn, thư viện nhắc bạn cập nhật. Đang dùng bản 0.5 với vnstock thế hệ 5: đọc hướng dẫn chuyển đổi trước khi cài.
Bạn có thể làm gì với vnstock_quant?
vnstock_quant là thư viện Python để tính chỉ báo kỹ thuật, chỉ số tài chính, thước đo rủi ro và hiệu suất, kết quả danh mục, mô hình định giá và chạy thử chiến lược theo luật thị trường Việt Nam. Phần tính toán nằm trong lõi Rust và chạy trên máy bạn.
Bạn đưa vào bảng pandas đã có, hoặc tải dữ liệu qua vnstock 6. vnstock 6 đọc Open API của công ty chứng khoán bằng khoá do chính bạn đăng ký ở đó. vnstock_quant không tự kết nối nguồn nào và không nhận khoá của nguồn.
Các công cụ, công thức và mô hình tính toán trong vnstock_quant được cung cấp cho mục đích học tập, nghiên cứu và phân tích định lượng độc lập trên môi trường cá nhân của người dùng. Mọi kết quả là đầu ra mô hình dựa trên các giả định và dữ liệu do bạn tự cung cấp, không cấu thành khuyến nghị đầu tư, tư vấn tài chính hay lời mời chào mua bán chứng khoán.
Khác gì so với bản 0.5
Các công thức không đổi. Khác biệt nằm ở dữ liệu tải về, vì thế hệ 6 chỉ đọc Open API chính thức và các bảng ở đó khác bảng thế hệ 5.
| Bản 0.5 (thế hệ 5) | Bản 1.0 (thế hệ 6) | |
|---|---|---|
| Thư viện dữ liệu | vnstock 5, cài kèm qua extra [vnstock] | vnstock 6 và vnstock-oapi, luôn cài kèm |
| Nguồn | Có nguồn mặc định | Không có nguồn mặc định: bạn nêu source= hoặc đặt quy tắc một lần |
| Khoá | Khoá API Vnstock | Khoá API Vnstock cho cấp quyền, cộng khoá Open API của từng nguồn bạn dùng |
| Hạn mức lượt gọi dữ liệu | Có | Không có; tần suất gọi do từng nguồn giới hạn |
Chỉ số định giá khi tải qua vnstock | Có giá gốc và số cổ phiếu theo ngày | Không có số cổ phiếu theo ngày, giá lịch sử đã điều chỉnh: định giá tắt kèm cảnh báo |
Giá điều chỉnh tải qua vnstock (prices.from_vnstock) | Chạy | Tạm tắt |
| Công cụ backtest gọi bằng JSON | 10 | 15 |
Chi tiết từng điểm và cách sửa mã: Chuyển từ bản 0.5. Mức hoàn thiện đo trên nguồn thật: Mức hoàn thiện.
Bản đồ tài liệu
Tài liệu xếp theo luồng làm việc. Trong mục Tính toán, mỗi trang ứng với một không gian tên: gõ vq.fa thì tìm trang /tinh-toan/fa.
| Mục | Trang | Trong mã | Giúp bạn làm gì? |
|---|---|---|---|
| Bắt đầu | Cài đặt, Quyền dùng và hạn mức, Quy ước dữ liệu và lỗi | vq.entitlement(), vq.errors | Cài gói, cất khoá nguồn, biết cấp của mình mở nhóm nào, đọc đúng dạng dữ liệu và mã lỗi. |
| Dữ liệu | Giá điều chỉnh | vnstock_quant.prices | Điều chỉnh bảng giá gốc của bạn theo sự kiện quyền. |
| Vi cấu trúc thị trường | vnstock_quant.micro | Nến từ dữ liệu khớp lệnh, bên chủ động, CVD, VPIN, biến động thực hiện. | |
| Tính toán | Chỉ báo kỹ thuật | vnstock_quant.ta | 58 chỉ báo xu hướng, động lượng, biến động, khối lượng và thống kê. |
| Chỉ số tài chính | vnstock_quant.fa | 100 chỉ số từ báo cáo tài chính theo bốn mẫu ngành. | |
| Rủi ro và hiệu suất | vnstock_quant.risk | 33 thước đo trên chuỗi lợi suất. | |
| Danh mục | vnstock_quant.portfolio | Lợi suất khi có nạp rút tiền, tái cân bằng, phân rã rủi ro, xây dựng danh mục. | |
| Định giá | vnstock_quant.valuation | Chiết khấu cổ tức, lợi suất và tăng trưởng ngầm định, P/E hợp lý. | |
| Backtest | Chạy thử chiến lược | vnstock_quant.backtest | Mô phỏng chiến lược theo luật thị trường Việt Nam; danh mục, dò tham số, walk-forward, Monte Carlo. |
| Tích hợp | Gọi bằng JSON và MCP, Tải dữ liệu bằng vnstock | catalog(), schema(), call() | Dùng các hàm làm công cụ cho trợ lý AI; tải dữ liệu qua vnstock 6. |
| Tham khảo | Đối chiếu kết quả và tốc độ, Mức hoàn thiện | Mốc đối chiếu, số đo tốc độ; tính năng nào chạy được trên nguồn thật và với điều kiện gì. | |
| Chuyển đổi | Từ bản 0.5, Từ vnstock_ta | Sửa mã viết cho bản 0.5 hoặc vnstock_ta 1.x. |
Mức độ ổn định
| Nhóm hàm | Mức | Bạn có thể dựa vào đến đâu? |
|---|---|---|
Chỉ báo kỹ thuật (ta) | Ổn định | Cách gọi và kết quả giữ nhất quán giữa các bản. |
fa, risk, portfolio, valuation, micro, backtest, gọi bằng JSON | Thử nghiệm | Dùng được để tìm hiểu và chạy thử; tên hàm, tham số và cấu trúc kết quả có thể còn đổi. |
prices | Thử nghiệm, tải qua vnstock tạm tắt | prices.adjust chạy với bảng giá gốc bạn tự có. |
Dữ liệu tải qua vnstock 6 | Thử nghiệm | vnstock 6 đánh dấu BCTC, giá theo phiên và lịch sự kiện qua Open API là thử nghiệm; thư viện nhắc một lần mỗi tiến trình. |
Với nhóm thử nghiệm, hãy đối chiếu kết quả với một cách tính độc lập, và ghim phiên bản trong dự án (pip show vnstock_quant).
Quyền dùng và hạn mức
Quyền được cấp theo nhóm tính năng, do máy chủ Vnstock quyết định; bảng nhóm theo cấp không đổi so với bản 0.5. Phép tính chạy trên máy bạn. Thế hệ 6 không có hạn mức lượt gọi dữ liệu; mỗi nguồn tự giới hạn tần suất gọi theo điều khoản của nguồn đó.
- Bản Cộng đồng: 10 chỉ báo kỹ thuật cơ bản, 10 chỉ số tài chính cơ bản (30 lượt thử mỗi ngày, tính chung) và backtest một mã với 10 chỉ báo đó (3 lượt thử mỗi ngày, tính riêng).
- Từ Bronze: đủ 100 chỉ số tài chính, rủi ro và hiệu suất, danh mục, định giá, giá điều chỉnh, vi cấu trúc thị trường, backtest đủ chỉ báo, danh mục, dò tham số, walk-forward, Monte Carlo.
- Từ Silver: đủ 58 chỉ báo kỹ thuật.
Bảng đầy đủ: Quyền dùng và hạn mức.
Đọc tiếp
- Cài đặt và thiết lập — Cài thư viện, cất khoá nguồn, chọn nguồn, kiểm tra cấp quyền.
- Tải dữ liệu bằng vnstock — Điểm vào tải dữ liệu của từng nhóm hàm và nguồn đọc được.
- Mức hoàn thiện — Kết quả chạy trên nguồn thật ngày 06/11/2026.
- Chuyển từ bản 0.5 — Những gì cần sửa trong mã cũ.
- Lịch sử phiên bản — Các mốc phát hành của thư viện.