Struct SignedRequestBuilder 

pub struct SignedRequestBuilder<'a> { /* private fields */ }

Builder for creating authenticated Binance API requests.

This builder encapsulates the common signing workflow:

1. Credential validation
2. Timestamp generation
3. Parameter signing with HMAC-SHA256
4. Authentication header injection
5. HTTP request execution

Example

let binance = Binance::new(ExchangeConfig::default())?;

let data = binance.signed_request("/api/v3/account")
    .param("symbol", "BTCUSDT")
    .optional_param("limit", Some(100))
    .execute()
    .await?;

Implementations

impl<'a> SignedRequestBuilder<'a>

pub fn new(binance: &'a Binance, endpoint: impl Into<String>) -> Self

Creates a new signed request builder.

Arguments

• binance - Reference to the Binance exchange instance
• endpoint - Full API endpoint URL

Example

let binance = Binance::new(ExchangeConfig::default()).unwrap();
let builder = SignedRequestBuilder::new(&binance, "https://api.binance.com/api/v3/account");

pub fn method(self, method: HttpMethod) -> Self

Sets the HTTP method for the request.

Default is GET.

Arguments

• method - The HTTP method to use

Example

let binance = Binance::new(ExchangeConfig::default())?;
let data = binance.signed_request("/api/v3/order")
    .method(HttpMethod::Post)
    .param("symbol", "BTCUSDT")
    .execute()
    .await?;

pub fn param(self, key: impl Into<String>, value: impl ToString) -> Self

Adds a required parameter.

Arguments

• key - Parameter name
• value - Parameter value (will be converted to string)

Example

let binance = Binance::new(ExchangeConfig::default())?;
let data = binance.signed_request("/api/v3/myTrades")
    .param("symbol", "BTCUSDT")
    .param("limit", 100)
    .execute()
    .await?;

pub fn optional_param<T: ToString>( self, key: impl Into<String>, value: Option<T>, ) -> Self

Adds an optional parameter (only if value is Some).

Arguments

• key - Parameter name
• value - Optional parameter value

Example

let binance = Binance::new(ExchangeConfig::default())?;
let since: Option<i64> = Some(1234567890);
let limit: Option<u32> = None;

let data = binance.signed_request("/api/v3/myTrades")
    .param("symbol", "BTCUSDT")
    .optional_param("startTime", since)
    .optional_param("limit", limit)  // Won't be added since it's None
    .execute()
    .await?;

pub fn params(self, params: BTreeMap<String, String>) -> Self

Adds multiple parameters from a BTreeMap.

Arguments

• params - Map of parameter key-value pairs

Example

let binance = Binance::new(ExchangeConfig::default())?;
let mut params = BTreeMap::new();
params.insert("symbol".to_string(), "BTCUSDT".to_string());
params.insert("side".to_string(), "BUY".to_string());

let data = binance.signed_request("/api/v3/order")
    .params(params)
    .execute()
    .await?;

pub fn merge_json_params(self, params: Option<Value>) -> Self

Merges parameters from a JSON Value object.

Only string, number, and boolean values are supported. Nested objects and arrays are ignored.

Arguments

• params - Optional JSON Value containing parameters

Example

let binance = Binance::new(ExchangeConfig::default())?;
let extra_params = Some(json!({
    "orderId": "12345",
    "fromId": 67890
}));

let data = binance.signed_request("/api/v3/myTrades")
    .param("symbol", "BTCUSDT")
    .merge_json_params(extra_params)
    .execute()
    .await?;

pub async fn execute(self) -> Result<Value>

Executes the signed request and returns the response.

This method:

1. Validates that credentials are configured
2. Gets the signing timestamp (using cached offset if available)
3. Signs the parameters with HMAC-SHA256
4. Adds authentication headers
5. Executes the HTTP request

Returns

Returns the raw serde_json::Value response for further parsing.

Errors

• Returns authentication error if credentials are missing
• Returns network error if the request fails
• Returns parse error if response parsing fails

Example

let binance = Binance::new(ExchangeConfig::default())?;
let data = binance.signed_request("/api/v3/account")
    .execute()
    .await?;
println!("Response: {:?}", data);