Enum BinanceError 

#[non_exhaustive]
pub enum BinanceError {
    Api(ApiError),
    Venue {
        status: u16,
        code: i64,
        msg: String,
    },
    RateLimited {
        retry_after: Option<Duration>,
    },
    IpBanned {
        retry_after: Option<Duration>,
    },
    RegionBlocked {
        msg: String,
    },
    Forbidden {
        msg: String,
    },
}

Error type for Binance API operations.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Api(ApiError)

Transport, decoding, or an error body in a shape Binance does not use.

Venue

Binance refused the request with its {"code", "msg"} body: an unknown symbol is 400 with code -1121.

Fields

status: u16

HTTP status.

code: i64

Binance’s error code, always negative.

msg: String

Binance’s message, clipped to 512 bytes.

RateLimited

Still answered 429 after the retry schedule ran out.

Fields

retry_after: Option<Duration>

The response’s Retry-After.

IpBanned

418: Binance has banned this IP for continuing after a 429. Every request on the same WeightBudget waits until the ban lifts.

Fields

retry_after: Option<Duration>

The response’s Retry-After. The docs give bans of 2 minutes to 3 days.

RegionBlocked

451: Binance does not serve the caller’s location.

Fields

msg: String

The response body, clipped to 512 bytes.

Forbidden

403: Binance’s web application firewall refused the request.

Fields

msg: String

The response body, clipped to 512 bytes.

Implementations

impl BinanceError

pub fn is_retriable(&self) -> bool

Whether re-sending the same request could plausibly succeed.

A 429, and a 408, 425 or 5xx however its body is shaped, are, as core’s ApiError::is_retriable says for those statuses. A ban, a region block and a firewall refusal are not: sending again does not change them, and sending after a 418 lengthens the ban.

pub fn code(&self) -> Option<i64>

Binance’s error code, for a Venue error.

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

The Retry-After delay, for a 429 or a 418 that carried one.

Trait Implementations

impl Debug for BinanceError

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

Formats the value using the given formatter.

impl Display for BinanceError

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

Formats the value using the given formatter.

impl Error for BinanceError

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<ApiError> for BinanceError

fn from(source: ApiError) -> Self

Converts to this type from the input type.

impl From<Error> for BinanceError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for BinanceError

fn from(err: ParseError) -> Self

Converts to this type from the input type.