Struct PrivateClient 

pub struct PrivateClient { /* private fields */ }

Client for the authenticated /sapi/v1/margin/* surface.

Margin has no public endpoints — for unauthenticated market data (klines, depth, tickers, exchange info) and connectivity (/api/v3/ping, /api/v3/time), use crate::spot::http::PublicClient.

Implementations

impl PrivateClient

pub fn new(cfg: PrivateConfig) -> Self

impl PrivateClient

pub async fn get_all_assets( &self, params: GetAllMarginAssetsParams, ) -> Result<Response<Vec<MarginAsset>>, Error>

Get all margin assets supported by the exchange.

impl PrivateClient

pub async fn margin_account( &self, params: GetMarginAccountParams, ) -> Result<Response<MarginAccount>, Error>

Get the caller’s cross-margin account snapshot (balances, level, etc.).

impl PrivateClient

pub async fn new_order( &self, params: NewOrderRequest, ) -> Result<Response<NewOrderResponse>, Error>

Place a new margin order.

Set is_isolated = IsIsolated::True to route the order to the isolated margin account for the symbol; otherwise the cross-margin account is used. Combine with [SideEffectType::MarginBuy] / [SideEffectType::AutoRepay] to opt into automatic borrowing or repayment when the order fills.

pub async fn query_order( &self, params: QueryOrderParams, ) -> Result<Response<Order>, Error>

Look up a single margin order by order_id or orig_client_order_id.

impl PrivateClient

pub async fn max_borrowable( &self, params: GetMaxBorrowableParams, ) -> Result<Response<MaxBorrowable>, Error>

Query the maximum borrowable amount for an asset.

Pass isolated_symbol to ask about the isolated account for a specific symbol; without it the call reports the cross-margin limit.

impl PrivateClient

pub async fn create_listen_key(&self) -> Result<Response<ListenKey>, Error>

Create a new listenKey for the cross-margin user data stream.

Returns a key that can be used to connect to wss://stream.binance.com:9443/ws/<listenKey>. The key expires after 60 minutes — extend via Self::keepalive_listen_key every 30 min.

pub async fn keepalive_listen_key( &self, listen_key: &str, ) -> Result<Response<EmptyResponse>, Error>

Extend a cross-margin listenKey’s lifetime by 60 minutes. Idempotent; safe to call on a schedule (recommended every 30 min).

pub async fn close_listen_key( &self, listen_key: &str, ) -> Result<Response<EmptyResponse>, Error>

Close a cross-margin listenKey. The WebSocket connection associated with the key will be dropped by the server.

impl PrivateClient

pub async fn create_isolated_listen_key( &self, symbol: &str, ) -> Result<Response<ListenKey>, Error>

Create a new listenKey for an isolated-margin account’s user data stream. Each isolated account has its own key.

pub async fn keepalive_isolated_listen_key( &self, symbol: &str, listen_key: &str, ) -> Result<Response<EmptyResponse>, Error>

Extend an isolated-margin listenKey’s lifetime by 60 minutes.

pub async fn close_isolated_listen_key( &self, symbol: &str, listen_key: &str, ) -> Result<Response<EmptyResponse>, Error>

Close an isolated-margin listenKey.