Mức độ hoàn thiện và lưu ý vận hành
Mục lục
Trang này cho biết nhóm hàm nào của bản Cộng đồng đã ổn định, nhóm nào đang thử nghiệm hay chạy kèm cảnh báo, và cần điều kiện gì để có đủ số liệu. Nguyên tắc xuyên suốt của bản 1.0: phép tính nào thiếu dữ liệu đầu vào chắc chắn đều được chủ động tắt hoặc cảnh báo kèm điều kiện, thay vì âm thầm trả một con số trông như thật nhưng sai.
Trạng thái theo nhóm hàm
Có nghĩa là đã ổn định, cách gọi giữ nhất quán giữa các bản. Thử nghiệm nghĩa là dùng được nhưng tên hàm, tham số hoặc cấu trúc kết quả còn có thể tinh chỉnh ở bản sau.
| Nhóm hàm | Mức | Điều kiện và giới hạn |
|---|---|---|
10 chỉ báo kỹ thuật (ta) | Có | Không có giới hạn đặc biệt |
10 chỉ số tài chính (fa) | Thử nghiệm | Chỉ số không áp dụng cho mẫu ngành trả NOT_APPLICABLE; báo cáo chỉ có chỉ tiêu cấp 1 thì chỉ số cần dòng chi tiết trả MISSING_INPUT |
Chỉ số định giá trong fa (P/E, P/B, EPS, BVPS) | Thử nghiệm | Cần giá đóng cửa gốc và số cổ phiếu lưu hành; thiếu thì trả MISSING_MARKET (xem mục dưới) |
Chạy thử chiến lược một mã (backtest) | Thử nghiệm | Không khai corporate_actions khi dùng giá đã điều chỉnh; cảnh báo khi dùng biểu phí chưa xác minh hoặc hồ sơ phái sinh |
Dữ liệu tải qua vnstock 6 | Thử nghiệm với báo cáo tài chính | Nến OHLCV dùng được trực tiếp; báo cáo tài chính được vnstock 6 đánh dấu thử nghiệm, nhắc một lần mỗi tiến trình |
Số liệu bạn nhận được còn phụ thuộc mã chứng khoán, khoảng thời gian và dữ liệu bạn đưa vào. Hãy đối chiếu thử trên tập dữ liệu của mình trước khi đưa vào quy trình ra quyết định.
Quy ước dễ gây lệch khi so với thư viện khác
ta: Giai đoạn khởi động đầu chuỗi của RSI, ATR, EMA có thể khác nhau giữa các thư viện; so từ đoạn sau khi chỉ báo đã hội tụ.fa: ROE, ROA dùng mẫu số bình quân; dòng quý 4 (bình quân 4 điểm cuối quý) có thể lệch nhẹ so với dòng năm.backtest: Phí, thuế bán, lô chẵn và bước giá áp theo hồ sơ sàn bạn chọn.
Chỉ số tài chính (fa)
- Mẫu ngành: Thư viện đọc mẫu ngành từ
attrs["template"]của bảng báo cáo; bảng tự nạp không cóattrsthì thư viện đoán từ danh sách chỉ tiêu. Muốn cố định, hãy truyềncom_type. - Báo cáo rút gọn (chỉ tiêu cấp 1): Chỉ tiêu chi tiết vắng mặt được hiểu là "chưa biết" chứ không phải
0, nên chỉ số cần chúng trảMISSING_INPUT. - Tần suất khi tải nhiều mã: Giới hạn do nguồn đặt; bị chạm thì báo
VNSTOCK_SOURCE_RATE_LIMITED. Hãy tải từng mã, lưu ra đĩa và dùngperiod="year"nếu chỉ cần số năm.
Bốn chỉ số định giá
- Số cổ phiếu lưu hành theo ngày: Chỉ số định giá trả
MISSING_MARKETtrừ khi bạn truyền cộttotal_shareshoặc bậtestimate_shares=True. Ước tính từ vốn điều lệ chia mệnh giá 10.000 đồng có thể lệch đáng kể sau các đợt phát hành, nên tuỳ chọn này không bật mặc định. - Giá đóng cửa gốc: Bảng giá đã điều chỉnh bị loại khỏi phép định giá kèm cảnh báo, vì giá đã điều chỉnh thấp hơn thị giá thật ở các phiên trước sự kiện quyền.
Để có đủ chuỗi định giá trong quá khứ, hãy nạp bảng giá đóng cửa gốc kèm total_shares qua fa.Dataset.from_frames().
Chạy thử chiến lược (backtest)
- Biểu phí: Mã biểu phí chưa đối chiếu với văn bản niêm yết có
verified=False; chạy với các mã này thì kết quả kèm cảnh báo. - Phái sinh: Hồ sơ
vn_futureschưa mô phỏng thuế phái sinh, phí quản lý vị thế qua đêm, phí quản lý ký quỹ, gọi ký quỹ bổ sung, tất toán bắt buộc và ngày đáo hạn; kết quả luôn có cảnh báo trongres.warnings. - Sự kiện cùng ngày: Cổ tức tiền và cổ phiếu thưởng cùng ngày giao dịch không hưởng quyền thì cổ tức tính trên số cổ phiếu trước khi nhận thưởng, không phụ thuộc thứ tự khai.
- Ngày niêm yết cổ phiếu thưởng: Thiếu
listing_datethì thư viện cảnh báo và cho bán ngay từ ngày giao dịch không hưởng quyền.
Nền tảng và môi trường
| Hạng mục | Bản 1.0 |
|---|---|
| Bản dựng sẵn | macOS (arm64, x86_64), Linux (aarch64, x86_64) và Windows (x86_64) |
| Phiên bản pandas | pandas 2.x và 3.x |
| Thời hạn bản cài | Bản chính thức dùng được 1 năm (xem vq.entitlement()["release"]["expires_at"]) |
Tài liệu đọc tiếp
- Nâng cấp từ bản 0.5 lên 1.0 — Những điểm cần cập nhật trong mã cũ.
- Chỉ số tài chính (FA) — Cách nạp giá gốc và số cổ phiếu cho chỉ số định giá.
- Đối chiếu kết quả và tốc độ xử lý — Mốc đối chiếu công thức.
