Struct BitgetSignedRequestBuilder 

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

Builder for creating authenticated Bitget API requests.

This builder encapsulates the common signing workflow:

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

Example

let bitget = Bitget::new(ExchangeConfig::default())?;

let data = bitget.signed_request("/api/v2/spot/account/assets")
    .param("symbol", "BTCUSDT")
    .optional_param("limit", Some(100))
    .execute()
    .await?;

Implementations

impl<'a> BitgetSignedRequestBuilder<'a>

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

Creates a new signed request builder.

Arguments

• bitget - Reference to the Bitget exchange instance
• endpoint - API endpoint path (e.g., “/api/v2/spot/account/assets”)

Example

let bitget = Bitget::new(ExchangeConfig::default()).unwrap();
let builder = BitgetSignedRequestBuilder::new(&bitget, "/api/v2/spot/account/assets");

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 bitget = Bitget::new(ExchangeConfig::default())?;
let data = bitget.signed_request("/api/v2/spot/trade/place-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 bitget = Bitget::new(ExchangeConfig::default())?;
let data = bitget.signed_request("/api/v2/spot/trade/orders-history")
    .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 bitget = Bitget::new(ExchangeConfig::default())?;
let since: Option<i64> = Some(1234567890000);
let limit: Option<u32> = None;

let data = bitget.signed_request("/api/v2/spot/trade/orders-history")
    .param("symbol", "BTCUSDT")
    .optional_param("after", 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 bitget = Bitget::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 = bitget.signed_request("/api/v2/spot/trade/place-order")
    .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 bitget = Bitget::new(ExchangeConfig::default())?;
let body = json!({
    "symbol": "BTCUSDT",
    "side": "buy",
    "orderType": "limit"
});

let data = bitget.signed_request("/api/v2/spot/trade/place-order")
    .method(ccxt_exchanges::bitget::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
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 bitget = Bitget::new(ExchangeConfig::default())?;
let data = bitget.signed_request("/api/v2/spot/account/assets")
    .execute()
    .await?;
println!("Response: {:?}", data);