abaquant.marketdata.errors

Import path: abaquant.marketdata.errors

Domain: Provider-neutral market-data facades, normalized records, caching, and analytics.

Purpose

Exception hierarchy for optional market-data workflows.

When to use it

Defines domain-specific exceptions that callers may catch explicitly. Use this package to retrieve or inject quotes, price history, option chains, and financial statements while preserving a stable analytical interface.

Public objects

  • class: MarketDataError — Base class for failures in the applied market-data layer.

  • class: MarketDataProviderError — Raised when a configured provider cannot supply usable data.

  • class: MarketDataValidationError — Raised when public market-data inputs violate a domain constraint.

  • class: UniverseValidationError — Raised when a ticker-universe request is invalid.

  • class: InsufficientHistoryError — Raised when available aligned history is too short for a calculation.

  • class: PortfolioValidationError — Raised when an applied portfolio request or allocation is invalid.

  • class: PortfolioOptimizationError — Raised when an applied portfolio optimizer cannot produce a valid solution.

  • class: OptionalDependencyError — Raised when an optional market-data provider dependency is unavailable.

Detailed reference

Exception hierarchy for optional market-data workflows.

Purpose

The module defines domain-specific errors that distinguish provider, validation, history, portfolio, and optional-dependency failures.

Conventions

Exceptions carry human-readable messages and are raised instead of leaking provider-specific implementation exceptions from the public layer.

References

[ 1 ] Black, F., and M. Scholes (1973), “The Pricing of Options and Corporate Liabilities”; Merton, R. C. (1973), “Theory of Rational Option Pricing”.

exception abaquant.marketdata.errors.MarketDataError

Bases: RuntimeError

Base class for failures in the applied market-data layer.

exception abaquant.marketdata.errors.MarketDataProviderError

Bases: MarketDataError

Raised when a configured provider cannot supply usable data.

exception abaquant.marketdata.errors.MarketDataValidationError

Bases: MarketDataError, ValueError

Raised when public market-data inputs violate a domain constraint.

exception abaquant.marketdata.errors.UniverseValidationError

Bases: MarketDataValidationError

Raised when a ticker-universe request is invalid.

exception abaquant.marketdata.errors.InsufficientHistoryError

Bases: MarketDataError

Raised when available aligned history is too short for a calculation.

exception abaquant.marketdata.errors.PortfolioValidationError

Bases: MarketDataValidationError

Raised when an applied portfolio request or allocation is invalid.

exception abaquant.marketdata.errors.PortfolioOptimizationError

Bases: MarketDataError

Raised when an applied portfolio optimizer cannot produce a valid solution.

exception abaquant.marketdata.errors.OptionalDependencyError

Bases: ImportError, MarketDataError

Raised when an optional market-data provider dependency is unavailable.