Giới thiệu
Mục lục
Khuyên dùng: Nên ưu tiên sử dụng Agent Guide để nạp môi trường cho AI Agent trên máy tính cục bộ. Tránh viết code thủ công hoặc dùng AI phiên bản web/Google Colab vì AI không có thông tin mới nhất về thư viện nên dễ viết sai cú pháp.
Tổng quan
vnstock_quant là thư viện tính toán định lượng chuyên sâu cho thị trường chứng khoán Việt Nam, sở hữu lõi tính toán Rust tốc độ cao và giao diện lập trình Python thân thiện.
Nhằm hỗ trợ cộng đồng các nhà đầu tư cá nhân, sinh viên và lập trình viên bước đầu làm quen với phương pháp phân tích định lượng (Quantitative Analysis), Vnstock có bản Cộng đồng, miễn phí cho cá nhân, học tập và nghiên cứu, gồm các tính năng sau:
- 10 chỉ báo kỹ thuật cơ bản: Bao gồm các công cụ phân tích xu hướng, động lượng và biến động phổ biến nhất (SMA, EMA, RSI, MACD, Stoch, Bollinger Bands, ATR, OBV, VWAP, Pivots).
- 10 chỉ số tài chính cơ bản: Bao gồm các tỷ số định giá và hiệu quả sinh lời thiết yếu từ báo cáo tài chính VAS (P/E, P/B, EPS, BVPS, ROE, ROA, GPM, NPM, D/E, Current Ratio).
- Lõi Rust tốc độ cao: Dùng chung lõi Rust với bản Mở rộng, kết quả được đối chiếu với TA-Lib C và nhất quán giữa các hệ điều hành.
- Hỗ trợ AI Agent: Bạn có thể sử dụng AI Agent (thông qua hệ thống kỹ năng
vnai) để viết mã và tự động phân tích định lượng với các chỉ báo và chỉ số sẵn có.
Lượt dùng thử của bản Cộng đồng
Bản Cộng đồng dành cho mục đích cá nhân, học tập và nghiên cứu, với các giới hạn dùng thử sau:
| Tiêu chí | Bản Cộng đồng |
|---|---|
| Số phép tính mỗi ngày | 30 lượt tính toán / ngày (tính chung cho cả chỉ báo kỹ thuật và chỉ số tài chính) |
| Số mã mỗi lần tải dữ liệu trực tiếp | Tối đa 3 mã cổ phiếu / lần gọi |
| Thời điểm làm mới lượt dùng thử | Tự động làm mới về 30 lượt vào lúc 00:00 giờ Việt Nam (UTC+7) mỗi ngày |
| Yêu cầu khoá bản quyền | Không cần khoá API tài trợ để bắt đầu |
Khi tính một chỉ báo kỹ thuật trên chuỗi nến lịch sử (ví dụ ta.rsi(length=14)), hệ thống tính là 1 lượt. Khi bạn dùng hết 30 lượt trong ngày, thư viện sẽ trả về thông báo lỗi QUANT_TRIAL_EXHAUSTED và tự động khôi phục sau 00:00.
Lượt dùng thử là giới hạn riêng của bản dùng thử. Ở mọi cấp, phép tính vẫn tính vào hạn mức chung của tài khoản, cùng quỹ với các thư viện Vnstock khác; xem phần trăm còn lại ở trang tài khoản.
So sánh phạm vi tính năng với bản Mở rộng
Để bạn nắm rõ phạm vi của từng bản, bảng dưới đây thể hiện sự khác biệt giữa bản Cộng đồng và các cấp tài trợ của bản Mở rộng:
| Nhóm tính năng | Bản Cộng đồng | Bản Mở rộng (cấp tài trợ) |
|---|---|---|
| Lượt dùng thử | 30 lượt/ngày | Không đếm lượt dùng thử (vẫn tính vào hạn mức chung) |
| Chỉ báo kỹ thuật (TA) | 10 chỉ báo cơ bản | Toàn bộ 58 chỉ báo từ cấp Silver (cấp Bronze: 10 chỉ báo cơ bản, không đếm lượt) |
| Chỉ số tài chính (FA) | 10 chỉ số cơ bản | Đủ 99 chỉ số VAS (4 mẫu ngành + CFA), từ cấp Bronze |
| Đo lường rủi ro (Risk) | Không hỗ trợ | Đủ 33 thước đo (Sharpe, VaR, Amihud), từ cấp Bronze |
| Quản lý danh mục (Portfolio) | Không hỗ trợ | Đủ 38 hàm (TWR/MWR, tối ưu hoá), từ cấp Bronze |
| Mô hình định giá (Valuation) | Không hỗ trợ | DDM Gordon, P/E hợp lý, từ cấp Bronze |
| Hỗ trợ AI Agent | Hỗ trợ (trong 30 lượt dùng thử/ngày) | Hỗ trợ |
Nếu bạn cần tính toán quy mô lớn cho nhiều mã chứng khoán hoặc muốn dùng các mô hình rủi ro và tối ưu hoá danh mục, bạn có thể gạt công tắc ở đầu thanh điều hướng sang tab Tài trợ để tham khảo toàn bộ tài liệu tính năng của bản Mở rộng.
Đọc tiếp
- Cài đặt & Khởi tạo — Cách cài đặt thư viện và kiểm tra số lượt dùng thử.
- Chỉ báo kỹ thuật — Hướng dẫn chi tiết 10 chỉ báo kỹ thuật của bản Cộng đồng.
- Chỉ số tài chính — Hướng dẫn 10 chỉ số BCTC phân tích doanh nghiệp.
- Chuyển đổi từ vnstock_ta — Cách chuyển mã nguồn cũ sang vnstock_quant.
- Lịch sử phiên bản — Lịch sử cập nhật của thư viện.