Enum BinanceDataError 

pub enum BinanceDataError {
    RateLimited {
        retry_after: Option<Duration>,
    },
    Api {
        status: u16,
        message: String,
    },
    Http {
        message: String,
    },
    Deserialize {
        message: String,
        payload: String,
    },
    InvalidInput {
        message: String,
    },
}

Errors returned by the Binance historical klines REST client.

The kline endpoints are public and unauthenticated, so there is no auth or environment-variable variant (contrast the massive feature’s MassiveError, which carries both). WebSocket disconnects are handled by the live path’s Connector, not here.

Variants

RateLimited

Rate limited by the API (HTTP 429) or IP-banned for repeat violations (HTTP 418). Carries the optional Retry-After duration parsed from the response header.

Contract

The historical Stream yields this error and ends — it does not wait, retry, or run a process-global limiter. The consumer owns retry/backoff and resumes losslessly by re-invoking fetch_candles with start advanced to last_close_time + 1ms (the next candle’s open). The [start, end] range is close_time-inclusive, so resuming exactly at the last close_time would re-yield that final candle; the +1ms step skips it without leaving a gap (pagination keys off open_time, and open ≡ close − interval).

Fields

retry_after: Option<Duration>

Api

API returned a non-success, non-rate-limit response (e.g. 400 Invalid symbol, 400 Invalid interval).

Fields

status: u16

message: String

Http

Network or HTTP client error (DNS, TLS, timeout, connection reset).

Fields

message: String

Deserialize

Response body could not be deserialised into the expected kline shape.

Fields

message: String

payload: String

InvalidInput

Client-side input validation failed before any request was made (e.g. empty symbol, or a candle whose close_time overflows the representable DateTime<Utc> range).

Fields

message: String

Trait Implementations

impl Clone for BinanceDataError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BinanceDataError

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

Formats the value using the given formatter.

impl Display for BinanceDataError

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

Formats the value using the given formatter.

impl Error for BinanceDataError

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 BinanceDataError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl PartialEq for BinanceDataError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BinanceDataError