Enum ApiError 

pub enum ApiError {
    Api {
        status: u16,
        message: String,
    },
    Authentication(String),
    Validation(String),
    RateLimit(String),
    Timeout,
    Network(Error),
    Serialization(Error),
    Url(ParseError),
}

Core API error types shared across Polyoxide clients

Variants

Api

HTTP request failed

Fields

status: u16

message: String

Authentication(String)

Authentication failed (401/403)

Validation(String)

Request validation failed (400)

RateLimit(String)

Rate limit exceeded (429)

Timeout

Request timeout

Network(Error)

Network error

Serialization(Error)

JSON serialization/deserialization error

Url(ParseError)

URL parsing error

Implementations

impl ApiError

pub async fn from_response(response: Response) -> Self

Create error from HTTP response

pub fn is_retriable(&self) -> bool

Whether re-sending the same request could plausibly produce a different result.

Intended as the canonical input to a caller’s retry policy, so consumers do not have to re-derive retriability from status codes or error prose.

Retriable: rate limits, timeouts, connection failures, 425 Too Early (Polymarket’s matching engine restarting), and any 5xx. Not retriable: authentication failures, validation failures, and local encode/decode errors — all of which are deterministic for a given request.

Note this describes the error, not the operation: a retriable error on a non-idempotent request (order placement) still needs caller-side judgement about whether resubmitting is safe.

Trait Implementations

impl Debug for ApiError

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

Formats the value using the given formatter.

impl Display for ApiError

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

Formats the value using the given formatter.

impl Error for ApiError

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 ApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for ApiError

fn from(source: ParseError) -> Self

Converts to this type from the input type.