Skip to content

Exceptions API Reference

All exceptions inherit from StockFeedError and support optional provider, ticker, and suggestion fields for actionable error messages.

Exception hierarchy

StockFeedError
├── ProviderError
│   ├── ProviderAuthError          # Invalid/missing API key
│   ├── ProviderRateLimitError     # Rate limit hit (.retry_after: float | None)
│   ├── ProviderUnavailableError   # Provider down or timeout
│   └── TickerNotFoundError        # Ticker doesn't exist on provider
├── CacheError
│   ├── CacheReadError
│   └── CacheWriteError
├── ValidationError                # Bad user input
├── UnsupportedIntervalError       # Provider doesn't support the interval
├── ConfigurationError             # Missing/invalid config
└── DevModeError                   # Dev-only feature used outside dev mode

Reference

Full exception hierarchy for stockfeed.

StockFeedError

Bases: Exception

Base exception for all stockfeed errors.

Source code in src/stockfeed/exceptions.py 
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
class StockFeedError(Exception):
    """Base exception for all stockfeed errors."""

    def __init__(
        self,
        message: str,
        provider: str | None = None,
        ticker: str | None = None,
        suggestion: str | None = None,
    ) -> None:
        self.message = message
        self.provider = provider
        self.ticker = ticker
        self.suggestion = suggestion
        super().__init__(message)

    def __str__(self) -> str:
        parts = [self.message]
        if self.provider:
            parts.append(f"provider={self.provider}")
        if self.ticker:
            parts.append(f"ticker={self.ticker}")
        if self.suggestion:
            parts.append(f"suggestion={self.suggestion}")
        return " | ".join(parts)

ProviderError

Bases: StockFeedError

Raised when a provider encounters an error.

Source code in src/stockfeed/exceptions.py 
31
32
class ProviderError(StockFeedError):
    """Raised when a provider encounters an error."""

ProviderAuthError

Bases: ProviderError

Invalid or missing API key.

Source code in src/stockfeed/exceptions.py 
35
36
class ProviderAuthError(ProviderError):
    """Invalid or missing API key."""

ProviderRateLimitError

Bases: ProviderError

Rate limit hit for a provider.

Source code in src/stockfeed/exceptions.py 
39
40
41
42
43
44
45
46
47
48
49
50
51
class ProviderRateLimitError(ProviderError):
    """Rate limit hit for a provider."""

    def __init__(
        self,
        message: str,
        provider: str | None = None,
        ticker: str | None = None,
        suggestion: str | None = None,
        retry_after: float | None = None,
    ) -> None:
        super().__init__(message, provider=provider, ticker=ticker, suggestion=suggestion)
        self.retry_after = retry_after

ProviderUnavailableError

Bases: ProviderError

Provider is down or timed out.

Source code in src/stockfeed/exceptions.py 
54
55
class ProviderUnavailableError(ProviderError):
    """Provider is down or timed out."""

TickerNotFoundError

Bases: ProviderError

Ticker doesn't exist on this provider.

Source code in src/stockfeed/exceptions.py 
58
59
class TickerNotFoundError(ProviderError):
    """Ticker doesn't exist on this provider."""

CacheError

Bases: StockFeedError

Raised when a cache operation fails.

Source code in src/stockfeed/exceptions.py 
62
63
class CacheError(StockFeedError):
    """Raised when a cache operation fails."""

CacheReadError

Bases: CacheError

Raised when reading from cache fails.

Source code in src/stockfeed/exceptions.py 
66
67
class CacheReadError(CacheError):
    """Raised when reading from cache fails."""

CacheWriteError

Bases: CacheError

Raised when writing to cache fails.

Source code in src/stockfeed/exceptions.py 
70
71
class CacheWriteError(CacheError):
    """Raised when writing to cache fails."""

ValidationError

Bases: StockFeedError

Bad user input (ticker format, date range, etc.).

Source code in src/stockfeed/exceptions.py 
74
75
class ValidationError(StockFeedError):
    """Bad user input (ticker format, date range, etc.)."""

UnsupportedIntervalError

Bases: StockFeedError

Provider doesn't support the requested interval.

Source code in src/stockfeed/exceptions.py 
78
79
class UnsupportedIntervalError(StockFeedError):
    """Provider doesn't support the requested interval."""

ConfigurationError

Bases: StockFeedError

Missing or invalid configuration.

Source code in src/stockfeed/exceptions.py 
82
83
class ConfigurationError(StockFeedError):
    """Missing or invalid configuration."""

DevModeError

Bases: StockFeedError

Dev-only feature used in non-dev context.

Source code in src/stockfeed/exceptions.py 
86
87
class DevModeError(StockFeedError):
    """Dev-only feature used in non-dev context."""