Errors — API Reference

BentoError <: Exception

Abstract root of every error type this package raises. Catch this if you want to handle any DatabentoAPI failure (auth, HTTP, etc.) without enumerating the concrete types.

BentoAuthError(msg) <: BentoError

Raised when the API key cannot be resolved or the gateway rejects authentication. Sources include the CRAM handshake on the Live TCP API and HTTP 401 Unauthorized responses on the Historical API.

BentoHttpError <: BentoError

Abstract supertype for HTTP-layer failures on the Historical API. Subtypes BentoClientError (4xx) and BentoServerError (5xx) carry the parsed response payload.

BentoClientError(status, case, message, docs_url, request_id, body) <: BentoHttpError

Raised when an HTTP request to the Historical API returns a 4xx status (bad request, missing parameters, dataset/symbol not found, etc.). The fields mirror Databento's standard error envelope; request_id is useful for support tickets.

BentoServerError(status, case, message, docs_url, request_id, body) <: BentoHttpError

Raised when an HTTP request to the Historical API returns a 5xx status (gateway timeout, internal error, etc.). Same field layout as BentoClientError; retrying after backoff is usually appropriate.