Struct ErrorCode 

pub struct ErrorCode(pub i64);

Numeric Binance error code, as returned in the code field of an error response body.

Kept as a newtype around i64 rather than a closed enum because Binance adds new codes over time and product-specific endpoints use codes outside the spot range. Use the named constants for the common ones and the is_* predicates for category-based handling; fall back to ErrorCode::raw for anything not classified.

Tuple Fields

0: i64

Implementations

impl ErrorCode

pub const fn new(code: i64) -> Self

pub const fn raw(self) -> i64

Raw numeric code as returned by Binance.

impl ErrorCode

pub const UNKNOWN: Self

pub const DISCONNECTED: Self

pub const UNAUTHORIZED: Self

pub const TOO_MANY_REQUESTS: Self

pub const UNEXPECTED_RESP: Self

pub const TIMEOUT: Self

pub const SERVER_BUSY: Self

pub const TOO_MANY_ORDERS: Self

pub const SERVICE_SHUTTING_DOWN: Self

pub const UNSUPPORTED_OPERATION: Self

pub const INVALID_TIMESTAMP: Self

pub const INVALID_SIGNATURE: Self

pub const TOO_MANY_CONNECTIONS: Self

pub const ILLEGAL_CHARS: Self

pub const TOO_MANY_PARAMETERS: Self

pub const MANDATORY_PARAM_EMPTY_OR_MALFORMED: Self

pub const UNKNOWN_PARAM: Self

pub const BAD_SYMBOL: Self

pub const INVALID_LISTEN_KEY: Self

pub const TOO_MANY_MESSAGES: Self

pub const TOO_MANY_SUBSCRIPTIONS: Self

pub const NEW_ORDER_REJECTED: Self

pub const CANCEL_REJECTED: Self

pub const NO_SUCH_ORDER: Self

pub const BAD_API_KEY_FMT: Self

pub const REJECTED_MBX_KEY: Self

pub const NO_TRADING_WINDOW: Self

pub const ORDER_AMEND_REJECTED: Self

pub const CLIENT_ORDER_ID_INVALID: Self

impl ErrorCode

pub fn is_auth(self) -> bool

Authentication / signing failure. The request will not succeed without fixing the API key, signature or timestamp.

Covers: UNAUTHORIZED (-1002), INVALID_TIMESTAMP (-1021), INVALID_SIGNATURE (-1022), BAD_API_KEY_FMT (-2014), REJECTED_MBX_KEY (-2015).

pub fn is_invalid_timestamp(self) -> bool

Local clock drifted outside the server’s recvWindow. Re-sync time and retry. Code: INVALID_TIMESTAMP (-1021).

pub fn is_invalid_signature(self) -> bool

HMAC signature doesn’t match. Usually a wrong API secret or a payload that was modified after signing. Code: INVALID_SIGNATURE (-1022).

pub fn is_bad_api_key_format(self) -> bool

API key format is invalid (length / characters). Code: -2014.

pub fn is_api_key_rejected(self) -> bool

API key was rejected because it’s been deleted/disabled, the source IP isn’t on its allowlist, or it lacks the permission this endpoint needs. Binance reports all three as code -2015.

pub fn is_wrong_permissions(self) -> bool

The key lacks the permission required for this action. Same wire code as Self::is_api_key_rejected (-2015); offered as a separate predicate purely for caller intent.

pub fn is_bad_request(self) -> bool

Request was malformed — missing/extra parameter, bad value, bad symbol, etc. Range: -1199..=-1100.

Product-specific codes outside this range (e.g. futures -4001) are not covered; use Self::raw to handle them.

pub fn is_rate_limited(self) -> bool

Rate-limit / throughput error. Caller is sending too much.

Covers: TOO_MANY_REQUESTS (-1003), TOO_MANY_ORDERS (-1015), TOO_MANY_CONNECTIONS (-1034), TOO_MANY_MESSAGES (-1181), TOO_MANY_SUBSCRIPTIONS (-1191).

pub fn is_server_error(self) -> bool

Server-side problem; the request itself may have been valid.

Covers: UNKNOWN (-1000), DISCONNECTED (-1001), UNEXPECTED_RESP (-1006), TIMEOUT (-1007), SERVER_BUSY (-1008), SERVICE_SHUTTING_DOWN (-1016).

pub fn is_transient(self) -> bool

Worth retrying — server-side or rate-limit. Auth / bad-request errors are not transient and will fail again on retry.

pub fn is_order_rejected(self) -> bool

Matching engine rejected the order (filter / price / quantity rules, cancel-replace failure, amend rejected).

Covers: NEW_ORDER_REJECTED (-2010), CANCEL_REJECTED (-2011), ORDER_AMEND_REJECTED (-2038).

pub fn is_no_such_order(self) -> bool

The referenced order ID doesn’t exist (already filled/canceled or never placed). Code: NO_SUCH_ORDER (-2013).

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCode

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

Formats the value using the given formatter.

impl Eq for ErrorCode

impl From<ErrorCode> for i64

fn from(code: ErrorCode) -> Self

Converts to this type from the input type.

impl From<i64> for ErrorCode

fn from(code: i64) -> Self

Converts to this type from the input type.

impl Hash for ErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorCode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ErrorCode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorCode