Enum MarketDataError 

pub enum MarketDataError {
    InvalidSymbol {
        symbol: String,
    },
    InvalidParameter {
        name: String,
        reason: String,
    },
    DeserializationError {
        source: Error,
    },
    RuntimeError {
        msg: String,
    },
    ConfigError(String),
    ConnectionError {
        msg: String,
    },
    AuthError {
        msg: String,
    },
    ApiError {
        status: u16,
        message: String,
    },
    TimeoutError {
        operation: String,
    },
    WebSocketError {
        kind: WebSocketErrorKind,
        msg: String,
    },
    HeartbeatTimeout {
        elapsed: Duration,
    },
    ClientClosed,
    Other(Error),
}

Main error type for marketdata-core operations

Variants

InvalidSymbol

Invalid symbol format or unsupported symbol

Fields

symbol: String

The offending symbol string that failed validation.

InvalidParameter

Invalid or missing parameter

Fields

name: String

Parameter name that failed validation.

reason: String

Human-readable explanation of why the parameter was rejected.

DeserializationError

JSON deserialization failed

Fields

source: Error

Underlying serde_json error.

RuntimeError

Runtime operation failed

Fields

msg: String

Diagnostic message describing the runtime failure.

ConfigError(String)

Configuration error

Tuple Fields

0: String

Diagnostic message identifying the misconfiguration.

ConnectionError

Connection to server failed

Fields

msg: String

Diagnostic message describing the connection failure.

AuthError

Authentication failed

Fields

msg: String

Diagnostic message describing the authentication failure.

ApiError

API returned error response

Fields

status: u16

HTTP status code returned by the server.

message: String

Server-provided error message.

TimeoutError

Operation timed out

Fields

operation: String

Human-readable name of the operation that timed out.

WebSocketError

WebSocket error

Fields

kind: WebSocketErrorKind

Structured classification of the underlying WebSocket failure. Branch on this rather than substring-matching msg for programmatic decision-making (retry, alert, fail fast).

msg: String

Diagnostic message describing the WebSocket failure.

HeartbeatTimeout

Inbound activity timed out: no frame received within the configured heartbeat_timeout window.

Fields

elapsed: Duration

Wall-clock interval that elapsed since the last inbound frame.

ClientClosed

Client has been closed and cannot be reused

Other(Error)

Other unexpected errors

Tuple Fields

0: Error

Underlying error wrapped via anyhow.

Implementations

impl MarketDataError

pub fn source_kind(&self) -> ErrorKind

Coarse-grained classification of the source of this error.

Returns one of ErrorKind::Network, ErrorKind::Protocol, ErrorKind::Auth, ErrorKind::RateLimit, or ErrorKind::Client so downstream code can branch on category without pattern-matching every variant.

Mapping

MarketDataError variant	ErrorKind
ConnectionError, TimeoutError, HeartbeatTimeout	Network
WebSocketError { kind: Protocol | Capacity | Utf8 | Other }	Protocol
WebSocketError { kind: Tls }	Auth
WebSocketError { kind: Io }	Network
WebSocketError { kind: Http(_) }	see WebSocketErrorKind::Http for the status-code mapping table
AuthError, ApiError { status: 401 | 403 }	Auth
ApiError { status: 429 }	RateLimit
ApiError { status: 500..=599 }	Network
ApiError { status: other 4xx }	Client
InvalidSymbol, InvalidParameter, ConfigError, DeserializationError, ClientClosed	Client
RuntimeError, Other	Client

pub fn to_error_code(&self) -> i32

Get numeric error code for FFI consumers

pub fn is_retryable(&self) -> bool

Check if error is retryable.

WebSocket retry verdict (0.6.0+)

Refined to honour WebSocketErrorKind:

Kind	Retryable
Protocol, Capacity, Utf8, Tls	no
Io, Other	yes
Http(429), Http(500..=599)	yes
Http(401 | 403)	no
Http(other)	no

Protocol violations are now correctly non-retryable — retrying the same SDK against the same server will keep failing. Pre-0.6.0 behaviour treated every WebSocket error as retryable, which was a footgun for monitor incident response.

Trait Implementations

impl Debug for MarketDataError

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

Formats the value using the given formatter.

impl Display for MarketDataError

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

Formats the value using the given formatter.

impl Error for MarketDataError

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<Error> for MarketDataError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MarketDataError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MarketDataError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MarketDataError

fn from(error: Error) -> Self

Converts to this type from the input type.