Cấp quyền và xử lý lỗi

Kiểm tra trạng thái quyền

vq.entitlement() chạy trên máy, không trừ lượt. Khoá backtest là phần riêng của mô-đun này:

import vnstock_quant as vq

state = vq.entitlement()
print(state["tier"], state["features"])      # features gồm bt_basic, bt, bt_portfolio, bt_optimize khi được mở
print(state["backtest"]["trial"])           # None nếu cấp của bạn không bị đếm lượt backtest riêng
print(state["backtest"]["quota"])           # quy mô tối đa của một lần chạy

Bản Cộng đồng và các cấp quyền sử dụng

Từ Bronze, bạn dùng được mọi tính năng của mô-đun. Các cấp quyền sử dụng chỉ khác nhau ở số lượt mỗi ngày và quy mô một lần chạy.

Bản Cộng đồng dùng được 10 chỉ báo trong bảng quy tắc, cùng nhóm chỉ báo mở cho bản Cộng đồng của vnstock_quant: sma, ema, rsi, macd, stoch, bbands, atr, obv, vwap, pivots. Bảng quy tắc dùng chỉ báo khác thì bị từ chối với QUANT_TIER_REQUIRED trước khi chạy, và không bị trừ lượt. Tín hiệu bạn tự tính bằng thư viện khác rồi đưa vào qua signals hay entries/exits thì không bị giới hạn này.

Cách đếm:

• Số lượt phụ thuộc vào hàm và quy mô lần chạy. run tính một lượt; run_portfolio tính một lượt mỗi mã; sweep và walk_forward tính theo số tổ hợp. Các hàm tính toán khác gồm monte_carlo, eval_rule_dsl, check_rule_dsl_causality và detect_limit_events. Xem số lượt còn lại trong vq.entitlement()["backtest"] trước khi chạy.
• Các hàm chỉ đọc không trừ lượt: list_brokers, list_profiles, list_presets, list_indicators, catalog, schema, vq.entitlement, vq.build_info.
• check_causality (kiểm tra hàm tín hiệu Python của bạn) và deflated_sharpe_ratio không trừ lượt.
• Lượt làm mới mỗi ngày theo giờ Việt Nam. trial["resets_at"] ghi thời điểm làm mới.
• Lượt backtest là dòng ngân sách riêng do máy chủ đặt cho mô-đun này, không trừ vào 30 phép tính mỗi ngày của chỉ báo và chỉ số tài chính. Với tài khoản đã đăng nhập, mọi lần chạy còn được tính vào hạn mức sử dụng chung của tài khoản, như các thư viện khác của Vnstock.
• Diamond không bị đếm lượt riêng cho mô-đun này, chỉ tính vào hạn mức sử dụng chung.

Số lượt mỗi ngày có thể được điều chỉnh mà không cần phát hành lại thư viện. Số đúng cho máy của bạn là số trong vq.entitlement()["backtest"].

Khi hết lượt, thư viện báo QUANT_TRIAL_EXHAUSTED. Khi một lần chạy vượt quy mô của cấp, thư viện báo QUANT_QUOTA_LIMIT kèm cấp chạy được quy mô đó.

Xử lý lỗi

Mọi lỗi của mô-đun thuộc cây VnstockQuantError của vnstock_quant (xem Cài đặt và thiết lập). Mỗi lỗi có:

• code: mã ổn định, dùng để rẽ nhánh trong mã của bạn;
• message: thông điệp tiếng Việt;
• kind: nhóm lỗi;
• retryable: có nên thử lại không;
• action: việc nên làm tiếp (nếu có).

from vnstock_quant import backtest as bt
from vnstock_quant.errors import EntitlementError, VnstockQuantError

try:
    res = bt.sweep(df, tasks, symbol="FPT")
except EntitlementError as e:          # TierRequiredError, QuotaExceededError
    print(e.code, e.message, e.action)
except VnstockQuantError as e:
    print(e.code, e.message)

Lớp ngoại lệ

Mã lỗi

Lỗi từ lớp xác thực dùng chung của hệ sinh thái mang mã VNSTOCK_AUTH_..., ví dụ khi khoá API không hợp lệ hoặc thiết bị vượt giới hạn. Các lỗi này thuộc EntitlementError và có action hướng dẫn cụ thể.