Struct PolymarketClobHttpClient 

pub struct PolymarketClobHttpClient { /* private fields */ }

Provides an authenticated HTTP client for the Polymarket CLOB REST API.

Handles HTTP transport, L2 HMAC-SHA256 auth signing, pagination, and raw API calls that closely match Polymarket endpoint specifications. Credential is always present: the CLOB API requires authentication.

Implementations

impl PolymarketClobHttpClient

pub fn new( credential: Credential, address: String, base_url: Option<String>, timeout_secs: u64, ) -> StdResult<Self, HttpClientError>

Creates a new authenticated PolymarketClobHttpClient.

Errors

Returns an error if the HTTP client cannot be created.

pub async fn get_orders( &self, params: GetOrdersParams, ) -> Result<Vec<PolymarketOpenOrder>>

Fetches all open orders matching the given parameters (auto-paginated).

pub async fn get_order_optional( &self, order_id: &str, ) -> Result<Option<PolymarketOpenOrder>>

Fetches a single open order by ID, returning None for empty/null responses.

pub async fn get_order(&self, order_id: &str) -> Result<PolymarketOpenOrder>

Fetches a single open order by ID.

Returns an error if the order is not found (empty/null response).

pub async fn get_trades( &self, params: GetTradesParams, ) -> Result<Vec<PolymarketTradeReport>>

Fetches all trades matching the given parameters (auto-paginated).

pub async fn get_balance_allowance( &self, params: GetBalanceAllowanceParams, ) -> Result<BalanceAllowance>

Fetches balance and allowance for the given parameters.

pub async fn post_order( &self, order: &PolymarketOrder, order_type: PolymarketOrderType, post_only: bool, ) -> Result<OrderResponse>

Submits a single signed order to the exchange.

pub async fn post_orders( &self, orders: &[(&PolymarketOrder, PolymarketOrderType, bool)], ) -> Result<Vec<OrderResponse>>

Submits a batch of signed orders to the exchange.

Each entry is (order, order_type, post_only).

pub async fn cancel_order(&self, order_id: &str) -> Result<CancelResponse>

Cancels a single order by ID.

pub async fn cancel_orders( &self, order_ids: &[&str], ) -> Result<BatchCancelResponse>

Cancels multiple orders by ID.

pub async fn cancel_all(&self) -> Result<BatchCancelResponse>

Cancels all open orders.

pub async fn cancel_market_orders( &self, params: CancelMarketOrdersParams, ) -> Result<BatchCancelResponse>

Cancels all orders for a specific market.

pub async fn get_tick_size(&self, token_id: &str) -> Result<TickSizeResponse>

Fetches the tick size for a token from the CLOB API.

pub async fn get_fee_rate(&self, token_id: &str) -> Result<FeeRateResponse>

Fetches the fee rate (in basis points) for a token from the CLOB API.

pub async fn get_book(&self, token_id: &str) -> Result<ClobBookResponse>

Fetches the order book for a token from the CLOB API (public endpoint).

Trait Implementations

impl Clone for PolymarketClobHttpClient

fn clone(&self) -> PolymarketClobHttpClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PolymarketClobHttpClient

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

Formats the value using the given formatter.