Enum AlpacaError 

pub enum AlpacaError {
    Http(String),
    Json(String),
    Api {
        status: u16,
        message: String,
        error_code: Option<ApiErrorCode>,
        request_id: Option<String>,
    },
    Auth(String),
    Config(String),
    WebSocket(String),
    RateLimit {
        retry_after_secs: u64,
        info: RateLimitInfo,
    },
    Network(String),
    Timeout(String),
    InvalidData(String),
    Validation(String),
    ValidationErrors(Vec<ValidationError>),
}

Error types for the Alpaca API client.

Variants

Http(String)

HTTP request errors.

Json(String)

JSON parsing errors.

Api

API errors returned by Alpaca with full details.

Fields

status: u16

HTTP status code.

message: String

Error message from the API.

error_code: Option<ApiErrorCode>

Alpaca-specific error code.

request_id: Option<String>

Request ID for debugging.

Auth(String)

Authentication errors.

Config(String)

Invalid configuration.

WebSocket(String)

WebSocket errors.

RateLimit

Rate limiting errors with retry information.

Fields

retry_after_secs: u64

Seconds to wait before retrying.

info: RateLimitInfo

Full rate limit information.

Network(String)

Network connectivity errors.

Timeout(String)

Timeout errors.

InvalidData(String)

Invalid data format.

Validation(String)

Validation errors with field-level details.

ValidationErrors(Vec<ValidationError>)

Multiple validation errors.

Implementations

impl AlpacaError

pub fn api(status: u16, message: impl Into<String>) -> AlpacaError

Creates an API error from HTTP status and message.

pub fn api_with_details( status: u16, message: impl Into<String>, error_code: ApiErrorCode, request_id: Option<String>, ) -> AlpacaError

Creates an API error with full details.

pub fn rate_limit(retry_after_secs: u64) -> AlpacaError

Creates a rate limit error.

pub fn rate_limit_with_info(info: RateLimitInfo) -> AlpacaError

Creates a rate limit error with full info.

pub fn is_retryable(&self) -> bool

Returns true if this error is retryable.

pub fn retry_after(&self) -> Option<u64>

Returns the retry-after duration in seconds, if applicable.

pub fn request_id(&self) -> Option<&str>

Returns the request ID if available.

pub fn status_code(&self) -> Option<u16>

Returns the HTTP status code if this is an API error.

Trait Implementations

impl Debug for AlpacaError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for AlpacaError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Error for AlpacaError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<AlpacaError> for WebSocketError

fn from(source: AlpacaError) -> Self

Converts to this type from the input type.

impl From<Error> for AlpacaError

fn from(err: Error) -> AlpacaError

Converts to this type from the input type.

impl From<Error> for AlpacaError

fn from(err: Error) -> AlpacaError

Converts to this type from the input type.