Vnstock Logo

Mức độ hoàn thiện và lưu ý vận hành

Cộng đồng

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àmMứ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ệmChỉ 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ệmCầ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ệmKhô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 6Thử nghiệm với báo cáo tài chínhNế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ó attrs thì thư viện đoán từ danh sách chỉ tiêu. Muốn cố định, hãy truyền com_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ùng period="year" nếu chỉ cần số năm.

Bốn chỉ số định giá

  1. Số cổ phiếu lưu hành theo ngày: Chỉ số định giá trả MISSING_MARKET trừ khi bạn truyền cột total_shares hoặc bật estimate_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.
  2. 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_futures chư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 trong res.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_date thì 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ụcBản 1.0
Bản dựng sẵnmacOS (arm64, x86_64), Linux (aarch64, x86_64) và Windows (x86_64)
Phiên bản pandaspandas 2.x và 3.x
Thời hạn bản càiBản chính thức dùng được 1 năm (xem vq.entitlement()["release"]["expires_at"])

Tài liệu đọc tiếp