Struct PublicRestClient 

pub struct PublicRestClient { /* private fields */ }

Shared unauthenticated HTTP client for exchange public REST endpoints.

Create once and clone cheaply — the underlying reqwest::Client pools connections across calls.

Example

use exchange_apiws::http::PublicRestClient;
use serde::Deserialize;

#[derive(Deserialize)]
struct ServerTime { serverTime: u64 }

let client = PublicRestClient::new("https://api.binance.com")?;
let ts: ServerTime = client.get("/api/v3/time", &[]).await?;
println!("Binance server time: {}", ts.serverTime);

Implementations

impl PublicRestClient

pub fn new(base_url: impl Into<String>) -> Result<Self>

Build a client pointed at base_url with the default 10 s timeout.

Errors

Returns ExchangeError::Config if the underlying reqwest client cannot be built (e.g. TLS initialisation failure).

pub fn with_timeout( base_url: impl Into<String>, timeout: Duration, ) -> Result<Self>

Build a client with a caller-specified per-request timeout.

Errors

Returns ExchangeError::Config if the underlying reqwest client cannot be built.

pub fn base_url(&self) -> &str

The base URL the client was constructed with.

pub async fn get<T: DeserializeOwned>( &self, path: &str, params: &[(&str, &str)], ) -> Result<T>

Public GET with jittered exponential-backoff retry.

params are percent-encoded and appended as a query string. The response body is deserialized directly as T with no envelope unwrapping — the caller is responsible for handling exchange-specific response shapes (Binance bare JSON, Bybit retCode, etc.).

Retry policy:

• Network errors (connect, timeout, DNS) are retried a few times with jittered exponential backoff.
• HTTP 429 responses honour the Retry-After header (seconds form). They do not consume the retry budget but are capped at a small fixed count before giving up.
• Other 4xx/5xx responses surface as ExchangeError::Api without retry.

Trait Implementations

impl Clone for PublicRestClient

fn clone(&self) -> PublicRestClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.