Struct BinanceRawFuturesHttpClient 

pub struct BinanceRawFuturesHttpClient { /* private fields */ }

Raw HTTP client for Binance Futures REST API.

Implementations

impl BinanceRawFuturesHttpClient

pub fn http_client(&self) -> &HttpClient

Returns a reference to the underlying HTTP client.

pub fn new( product_type: BinanceProductType, environment: BinanceEnvironment, api_key: Option<String>, api_secret: Option<String>, base_url_override: Option<String>, recv_window: Option<u64>, timeout_secs: Option<u64>, proxy_url: Option<String>, ) -> BinanceFuturesHttpResult<Self>

Creates a new Binance raw futures HTTP client.

Errors

Returns an error if credentials are incomplete or the HTTP client fails to build.

pub async fn get<P, T>( &self, path: &str, params: Option<&P>, signed: bool, use_order_quota: bool, ) -> BinanceFuturesHttpResult<T>

where P: Serialize + ?Sized, T: DeserializeOwned,

Performs a GET request and deserializes the response body.

Errors

Returns an error if the request fails or response deserialization fails.

pub async fn post<P, T>( &self, path: &str, params: Option<&P>, body: Option<Vec<u8>>, signed: bool, use_order_quota: bool, ) -> BinanceFuturesHttpResult<T>

where P: Serialize + ?Sized, T: DeserializeOwned,

Performs a POST request with optional body and signed query.

Errors

Returns an error if the request fails or response deserialization fails.

pub async fn request_put<P, T>( &self, path: &str, params: Option<&P>, signed: bool, use_order_quota: bool, ) -> BinanceFuturesHttpResult<T>

where P: Serialize + ?Sized, T: DeserializeOwned,

Performs a PUT request with signed query.

Errors

Returns an error if the request fails or response deserialization fails.

pub async fn request_delete<P, T>( &self, path: &str, params: Option<&P>, signed: bool, use_order_quota: bool, ) -> BinanceFuturesHttpResult<T>

where P: Serialize + ?Sized, T: DeserializeOwned,

Performs a DELETE request with signed query.

Errors

Returns an error if the request fails or response deserialization fails.

pub async fn batch_request<T: Serialize>( &self, path: &str, items: &[T], use_order_quota: bool, ) -> BinanceFuturesHttpResult<Vec<BatchOrderResult>>

Performs a batch POST request with batchOrders parameter.

Errors

Returns an error if credentials are missing, the request fails, or JSON parsing fails.

pub async fn batch_request_delete<T: Serialize>( &self, path: &str, items: &[T], use_order_quota: bool, ) -> BinanceFuturesHttpResult<Vec<BatchOrderResult>>

Performs a batch DELETE request with batchOrders parameter.

Errors

Returns an error if credentials are missing, the request fails, or JSON parsing fails.

pub async fn batch_request_put<T: Serialize>( &self, path: &str, items: &[T], use_order_quota: bool, ) -> BinanceFuturesHttpResult<Vec<BatchOrderResult>>

Performs a batch PUT request with batchOrders parameter.

Errors

Returns an error if credentials are missing, the request fails, or JSON parsing fails.

pub async fn ticker_24h( &self, params: &BinanceTicker24hrParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesTicker24hr>>

Fetches 24hr ticker statistics.

Errors

Returns an error if the request fails.

pub async fn book_ticker( &self, params: &BinanceBookTickerParams, ) -> BinanceFuturesHttpResult<Vec<BinanceBookTicker>>

Fetches best bid/ask prices.

Errors

Returns an error if the request fails.

pub async fn price_ticker( &self, symbol: Option<&str>, ) -> BinanceFuturesHttpResult<Vec<BinancePriceTicker>>

Fetches price ticker.

Errors

Returns an error if the request fails.

pub async fn depth( &self, params: &BinanceDepthParams, ) -> BinanceFuturesHttpResult<BinanceOrderBook>

Fetches order book depth.

Errors

Returns an error if the request fails.

pub async fn mark_price( &self, params: &BinanceMarkPriceParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesMarkPrice>>

Fetches mark price and funding rate.

Errors

Returns an error if the request fails.

pub async fn funding_rate( &self, params: &BinanceFundingRateParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFundingRate>>

Fetches funding rate history.

Errors

Returns an error if the request fails.

pub async fn open_interest( &self, params: &BinanceOpenInterestParams, ) -> BinanceFuturesHttpResult<BinanceOpenInterest>

Fetches current open interest for a symbol.

Errors

Returns an error if the request fails.

pub async fn trades( &self, params: &BinanceTradesParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesTrade>>

Fetches recent public trades for a symbol.

Errors

Returns an error if the request fails.

pub async fn klines( &self, params: &BinanceKlinesParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesKline>>

Fetches kline/candlestick data for a symbol.

Errors

Returns an error if the request fails.

pub async fn set_leverage( &self, params: &BinanceSetLeverageParams, ) -> BinanceFuturesHttpResult<BinanceLeverageResponse>

Sets leverage for a symbol.

Errors

Returns an error if the request fails.

pub async fn set_margin_type( &self, params: &BinanceSetMarginTypeParams, ) -> BinanceFuturesHttpResult<Value>

Sets margin type for a symbol.

Errors

Returns an error if the request fails.

pub async fn query_hedge_mode( &self, ) -> BinanceFuturesHttpResult<BinanceHedgeModeResponse>

Queries hedge mode (dual side position) setting.

Errors

Returns an error if the request fails.

pub async fn create_listen_key( &self, ) -> BinanceFuturesHttpResult<ListenKeyResponse>

Creates a listen key for user data stream.

Errors

Returns an error if the request fails.

pub async fn keepalive_listen_key( &self, listen_key: &str, ) -> BinanceFuturesHttpResult<()>

Keeps alive an existing listen key.

Errors

Returns an error if the request fails.

pub async fn close_listen_key( &self, listen_key: &str, ) -> BinanceFuturesHttpResult<()>

Closes an existing listen key.

Errors

Returns an error if the request fails.

pub async fn query_account( &self, ) -> BinanceFuturesHttpResult<BinanceFuturesAccountInfo>

Fetches account information including balances and positions.

Errors

Returns an error if the request fails.

pub async fn query_positions( &self, params: &BinancePositionRiskParams, ) -> BinanceFuturesHttpResult<Vec<BinancePositionRisk>>

Fetches position risk information.

Errors

Returns an error if the request fails.

pub async fn query_user_trades( &self, params: &BinanceUserTradesParams, ) -> BinanceFuturesHttpResult<Vec<BinanceUserTrade>>

Fetches user trades for a symbol.

Errors

Returns an error if the request fails.

pub async fn query_order( &self, params: &BinanceOrderQueryParams, ) -> BinanceFuturesHttpResult<BinanceFuturesOrder>

Queries a single order by order ID or client order ID.

Errors

Returns an error if the request fails.

pub async fn query_open_orders( &self, params: &BinanceOpenOrdersParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesOrder>>

Queries all open orders.

Errors

Returns an error if the request fails.

pub async fn query_all_orders( &self, params: &BinanceAllOrdersParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesOrder>>

Queries all orders (including historical).

Errors

Returns an error if the request fails.

pub async fn submit_order( &self, params: &BinanceNewOrderParams, ) -> BinanceFuturesHttpResult<BinanceFuturesOrder>

Submits a new order.

Errors

Returns an error if the request fails.

pub async fn submit_order_list( &self, orders: &[BatchOrderItem], ) -> BinanceFuturesHttpResult<Vec<BatchOrderResult>>

Submits multiple orders in a single request (up to 5 orders).

Errors

Returns an error if the batch exceeds 5 orders or the request fails.

pub async fn modify_order( &self, params: &BinanceModifyOrderParams, ) -> BinanceFuturesHttpResult<BinanceFuturesOrder>

Modifies an existing order (price and quantity only).

Errors

Returns an error if the request fails.

pub async fn batch_modify_orders( &self, modifies: &[BatchModifyItem], ) -> BinanceFuturesHttpResult<Vec<BatchOrderResult>>

Modifies multiple orders in a single request (up to 5 orders).

Errors

Returns an error if the batch exceeds 5 orders or the request fails.

pub async fn cancel_order( &self, params: &BinanceCancelOrderParams, ) -> BinanceFuturesHttpResult<BinanceFuturesOrder>

Cancels an existing order.

Errors

Returns an error if the request fails.

pub async fn cancel_all_orders( &self, params: &BinanceCancelAllOrdersParams, ) -> BinanceFuturesHttpResult<BinanceCancelAllOrdersResponse>

Cancels all open orders for a symbol.

Errors

Returns an error if the request fails.

pub async fn batch_cancel_orders( &self, cancels: &[BatchCancelItem], ) -> BinanceFuturesHttpResult<Vec<BatchOrderResult>>

Cancels multiple orders in a single request (up to 5 orders).

Errors

Returns an error if the batch exceeds 5 orders or the request fails.

pub async fn submit_algo_order( &self, params: &BinanceNewAlgoOrderParams, ) -> BinanceFuturesHttpResult<BinanceFuturesAlgoOrder>

Submits a new algo order (conditional order).

Algo orders include STOP_MARKET, STOP (stop-limit), TAKE_PROFIT, TAKE_PROFIT_MARKET, and TRAILING_STOP_MARKET order types.

Errors

Returns an error if the request fails.

pub async fn cancel_algo_order( &self, params: &BinanceAlgoOrderQueryParams, ) -> BinanceFuturesHttpResult<BinanceFuturesAlgoOrderCancelResponse>

Cancels an algo order.

Must provide either algo_id or client_algo_id.

Errors

Returns an error if the request fails.

pub async fn query_algo_order( &self, params: &BinanceAlgoOrderQueryParams, ) -> BinanceFuturesHttpResult<BinanceFuturesAlgoOrder>

Queries a single algo order.

Must provide either algo_id or client_algo_id.

Errors

Returns an error if the request fails.

pub async fn query_open_algo_orders( &self, params: &BinanceOpenAlgoOrdersParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesAlgoOrder>>

Queries all open algo orders.

Errors

Returns an error if the request fails.

pub async fn query_all_algo_orders( &self, params: &BinanceAllAlgoOrdersParams, ) -> BinanceFuturesHttpResult<Vec<BinanceFuturesAlgoOrder>>

Queries all algo orders including historical (7-day limit).

Errors

Returns an error if the request fails.

pub async fn cancel_all_algo_orders( &self, params: &BinanceCancelAllAlgoOrdersParams, ) -> BinanceFuturesHttpResult<BinanceCancelAllOrdersResponse>

Cancels all open algo orders for a symbol.

Errors

Returns an error if the request fails.

Trait Implementations

impl Clone for BinanceRawFuturesHttpClient

fn clone(&self) -> BinanceRawFuturesHttpClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BinanceRawFuturesHttpClient

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

Formats the value using the given formatter.