Skip to main content

ServerTimeResponse

Type Alias ServerTimeResponse 

Source
pub type ServerTimeResponse = BybitApiResponse<ServerTime>;
Expand description

Represents the response from Bybit’s server time endpoint.

This struct is returned when querying the server time via the Bybit API (/v5/market/time). It provides the current server time, which is critical for synchronizing trading bot operations with Bybit’s server to avoid timestamp-related errors in API requests.

Aliased Type§

pub struct ServerTimeResponse {
    pub ret_code: i32,
    pub ret_msg: String,
    pub result: ServerTime,
    pub ret_ext_info: Empty,
    pub time: u64,
}

Fields§

§ret_code: i32

The return code indicating the success or failure of the request.

A value of 0 indicates success, while non-zero values correspond to specific error codes as defined in the Bybit API documentation (e.g., 10001 for invalid parameters). Trading bots should check this field to handle errors gracefully, such as retrying requests or logging issues for debugging.

§ret_msg: String

A human-readable message describing the result or error.

For successful requests, this is typically "OK". For errors, it provides a description of the issue (e.g., "invalid timestamp"). Bots should log this field for debugging and user feedback, especially when ret_code is non-zero.

§result: ServerTime

Contains the actual payload corresponding to the requested endpoint, as JSON.

§ret_ext_info: Empty

Additional information, typically an empty object.

This field is usually an empty Empty struct ({}) and can be ignored in most cases. However, bots should verify its presence to ensure response consistency.

§time: u64

The timestamp of the response in milliseconds.

This represents the time the response was generated by Bybit’s server. Trading bots can use this to measure latency or further synchronize operations, though result.time_second is typically more relevant for timestamp validation.