Xử lý lỗi

Exception
└── VnstockError
    ├── InputError              (cũng là ValueError)
    ├── AuthError
    ├── EntitlementError
    ├── NetworkError
    │   └── DataSourceBlockedError
    │       ├── RateLimitedError
    │       ├── AccessDeniedError
    │       ├── ChallengeRequiredError
    │       └── CircuitOpenError
    ├── ProviderError
    ├── SchemaError
    ├── UnsupportedError
    └── InternalError

from vnstock.core.exceptions import (
    VnstockError, InputError, AuthError, EntitlementError, NetworkError,
    ProviderError, SchemaError, UnsupportedError, InternalError,
    DataSourceBlockedError, RateLimitedError, AccessDeniedError,
    ChallengeRequiredError, CircuitOpenError,
)

from vnstock import Fundamental
from vnstock.core.exceptions import EntitlementError

try:
    Fundamental().equity("FPT").ratio()
except EntitlementError as e:
    print(e.code)        # VNSTOCK_TIER_ROUTE
    print(e.kind)        # entitlement
    print(e.route)       # fundamental.equity.ratio
    print(e.retryable)   # False
    print(e.message_vi)  # Chức năng 'fundamental.equity.ratio' không thuộc quyền của cấp Khách.
    print(e.action_vi)
    # Đăng nhập bằng khoá API cấp Cộng đồng (lấy tại https://vnstocks.com/account#api-key),
    # hoặc xem các cấp tài trợ tại https://vnstocks.com/insiders-program.

from vnstock import Market, Retail
from vnstock.core.exceptions import InputError, UnsupportedError

try:
    Retail().gold()
except UnsupportedError as e:
    print(e.code)        # VNSTOCK_FEATURE_REMOVED
    print(e.message_vi)  # `Retail().gold()` đã ngừng hỗ trợ từ vnstock 5.0.0a3 và không còn trả dữ liệu.

try:
    Market().equity("ZZZQ").ohlcv(start="2026-10-01", end="2026-10-09")
except InputError as e:
    print(e.code)        # VNSTOCK_INPUT_SYMBOL_UNKNOWN
    print(e.provider)    # vci
    print(e.message_vi)  # Nguồn 'vci' không có mã 'ZZZQ'.
    print(e.action_vi)   # Kiểm tra lại mã, ví dụ tra trong Reference().equity.list().

Nguồn 'msn' không phục vụ market.equity.ohlcv. Nguồn dùng được: 'vci', 'asean', 'mas', 'kbs', 'vnd'.

import time

from vnstock import Market
from vnstock.core.exceptions import (
    AuthError, EntitlementError, InputError, NetworkError,
    ProviderError, RateLimitedError, UnsupportedError, VnstockError,
)


def daily_bars(symbol, start, end):
    try:
        return Market().equity(symbol).ohlcv(start=start, end=end)
    except InputError:               # sửa lời gọi, đừng thử lại
        raise
    except (AuthError, EntitlementError) as e:
        if e.retryable:              # hết lượt theo phút hoặc giờ
            time.sleep(60)
            return Market().equity(symbol).ohlcv(start=start, end=end)
        raise                        # cấp hoặc khoá: thử lại không giúp gì
    except RateLimitedError:
        time.sleep(60)               # nguồn báo gọi quá nhanh
        return Market().equity(symbol).ohlcv(start=start, end=end)
    except (NetworkError, ProviderError) as e:
        print(f"[{e.code}] {e.message_vi}")
        return None
    except UnsupportedError as e:    # hàm đã ngừng, bản hết hạn, nguồn bị tắt
        print(e.action or e.message_vi)
        raise
    except VnstockError as e:        # mọi lỗi còn lại của thư viện
        print(f"[{e.code}] {e}")
        raise

try:
    df = Market().equity("FPT").ohlcv(start="2026-10-01", end="2026-10-09", source="mas")
except VnstockError as e:
    if e.code == "VNSTOCK_TIER_SOURCE":
        df = Market().equity("FPT").ohlcv(start="2026-10-01", end="2026-10-09")
    else:
        raise

from vnstock import circuit_status, reset_circuit

circuit_status()   # {}  luôn rỗng: không có máy chủ nào đang tạm ngừng
reset_circuit()    # 0   không có gì để xoá

if any(k.startswith("tier_cap_") for k in df.attrs):
    raise RuntimeError(f"Kết quả bị cắt theo cấp: {dict(df.attrs)}")

vnstock doctor
vnstock version