HKUDS/Vibe-Trading · error · ValueError

Unhandled barrier type

Error message

Unhandled barrier type {b_type}

What it means

barrier_option_price dispatches the CALL pricing branch over the four canonical barrier types (down-and-out, down-and-in, up-and-out, up-and-in). Reaching the else clause means b_type is not one of them — in practice only possible if normalise_barrier_type's alias table is extended or bypassed, since the type was normalised earlier. It is a defensive internal invariant check for the call leg.

Solutions

1. If extending barrier types, add matching elif branches in both the CALL and PUT legs plus tests.
2. Do not monkey-patch the alias tables; request the type upstream instead.
3. As an end user hitting this, report it — your installed copy is patched or inconsistent; reinstall the package.

try:
    px = barrier_option_price(...)
except ValueError as e:
    if 'Unhandled barrier type' in str(e):
        raise RuntimeError('inconsistent quantlib install: report upstream') from e
    raise

When it happens

Trigger: Not reachable through the public API with stock aliases; triggered if the module's BARRIER_TYPES is monkey-patched, an unmapped alias slips through a patched _BARRIER_ALIASES, or internal code calls the branch with a raw string.

Common situations: Library maintainers adding a new barrier type (e.g. double-no-touch) and forgetting the call-leg dispatch; tests that patch the alias table; downstream forks that extend the enum.

Understand the failure class

Background: "This is a bug, please report it": internal invariant violations, unreachable panics, and SNH errors explained — this error's family across 47 libraries.

Related errors

• Spot, strike, and barrier must be strictly positive, got S=
• unknown barrier type
• legs[ ] has invalid strike or qty
• legs[ ] must be an object
• legs[ ].premium must be numeric or null

AI-assisted analysis of HKUDS/Vibe-Trading@80ffdda44c (2026-08-28). Data as JSON: /api/errors/de3502b440d1277d. Report an issue: GitHub.

Appendix: source

Thrown at agent/src/quantlib/options.py:622

    ) * norm.cdf(eta * (y2 - sigma_sqrt_T))

    # Cash rebate component
    if rebate > 0.0:
        E = rebate * df_r * (norm.cdf(eta * (x2 - sigma_sqrt_T)) - (hs_ratio ** (2.0 * mu)) * norm.cdf(eta * (y2 - sigma_sqrt_T)))
    else:
        E = 0.0

    if opt_type == _CALL:
        if b_type == "down-and-out":
            price = (A - C + (rebate * df_r - E)) if K >= H else (B - D + (rebate * df_r - E))
        elif b_type == "down-and-in":
            price = (C + E) if K >= H else (A - B + D + E)
        elif b_type == "up-and-out":
            price = (rebate * df_r - E) if K >= H else (A - B + C - D + (rebate * df_r - E))
        elif b_type == "up-and-in":
            price = (A + E) if K >= H else (B - C + D + E)
        else:
            raise ValueError(f"Unhandled barrier type {b_type}")
    else:  # PUT
        if b_type == "down-and-out":
            price = (A - B + C - D + (rebate * df_r - E)) if K >= H else (rebate * df_r - E)
        elif b_type == "down-and-in":
            price = (B - C + D + E) if K >= H else (A + E)
        elif b_type == "up-and-out":
            price = (B - D + (rebate * df_r - E)) if K >= H else (A - C + (rebate * df_r - E))
        elif b_type == "up-and-in":
            price = (A - B + D + E) if K >= H else (C + E)
        else:
            raise ValueError(f"Unhandled barrier type {b_type}")

    return float(max(0.0, price))

View on GitHub (pinned to 80ffdda44c)