Struct BybitSignedRequestBuilder 

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

Builder for creating authenticated Bybit API requests.

This builder encapsulates the common signing workflow:

1. Credential validation
2. Millisecond timestamp generation
3. Parameter signing with HMAC-SHA256 (hex encoded)
4. Authentication header injection (X-BAPI-* headers)
5. HTTP request execution

Bybit Signature Format

Bybit uses a unique signature format:

• Sign string: timestamp + api_key + recv_window + params
• For GET: params is the query string
• For POST: params is the JSON body string
• Signature is hex-encoded HMAC-SHA256

Example

let bybit = Bybit::new(ExchangeConfig::default())?;

let data = bybit.signed_request("/v5/account/wallet-balance")
    .param("accountType", "UNIFIED")
    .optional_param("coin", Some("BTC"))
    .execute()
    .await?;

Implementations

impl<'a> BybitSignedRequestBuilder<'a>

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

Creates a new signed request builder.

Arguments

• bybit - Reference to the Bybit exchange instance
• endpoint - API endpoint path (e.g., “/v5/account/wallet-balance”)

Example

let bybit = Bybit::new(ExchangeConfig::default()).unwrap();
let builder = BybitSignedRequestBuilder::new(&bybit, "/v5/account/wallet-balance");

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 bybit = Bybit::new(ExchangeConfig::default())?;
let data = bybit.signed_request("/v5/order/create")
    .method(HttpMethod::Post)
    .param("category", "spot")
    .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 bybit = Bybit::new(ExchangeConfig::default())?;
let data = bybit.signed_request("/v5/order/realtime")
    .param("category", "spot")
    .param("symbol", "BTCUSDT")
    .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 bybit = Bybit::new(ExchangeConfig::default())?;
let since: Option<i64> = Some(1234567890000);
let limit: Option<u32> = None;

let data = bybit.signed_request("/v5/order/history")
    .param("category", "spot")
    .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 bybit = Bybit::new(ExchangeConfig::default())?;
let mut params = BTreeMap::new();
params.insert("category".to_string(), "spot".to_string());
params.insert("symbol".to_string(), "BTCUSDT".to_string());

let data = bybit.signed_request("/v5/order/create")
    .params(params)
    .execute()
    .await?;

pub fn body(self, body: Value) -> Self

Sets the request body for POST/DELETE requests.

Arguments

• body - JSON value to use as request body

Example

let bybit = Bybit::new(ExchangeConfig::default())?;
let body = json!({
    "category": "spot",
    "symbol": "BTCUSDT",
    "side": "Buy",
    "orderType": "Limit"
});

let data = bybit.signed_request("/v5/order/create")
    .method(ccxt_exchanges::bybit::signed_request::HttpMethod::Post)
    .body(body)
    .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 current millisecond timestamp
3. Signs the request with HMAC-SHA256 (hex encoded)
4. Adds authentication headers (X-BAPI-*)
5. Executes the HTTP request

Bybit Signature Details

• Sign string format: timestamp + api_key + recv_window + params
• For GET requests: params is the query string
• For POST requests: params is the JSON body string
• Signature is hex-encoded (not Base64 like OKX/Bitget)

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 bybit = Bybit::new(ExchangeConfig::default())?;
let data = bybit.signed_request("/v5/account/wallet-balance")
    .param("accountType", "UNIFIED")
    .execute()
    .await?;
println!("Response: {:?}", data);