Struct ADLAlertUpdate 

pub struct ADLAlertUpdate {
    pub topic: String,
    pub event_type: String,
    pub timestamp: u64,
    pub data: Vec<ADLAlertWebsocketItem>,
}

Represents a WebSocket ADL alert update event.

Contains real-time ADL alert information for various trading pairs. Push frequency: 1 second for USDT Perpetual/Delivery, USDC Perpetual/Delivery, and Inverse Contracts.

Bybit API Reference

Topic: adlAlert.{coin} where coin can be:

• adlAlert.USDT for USDT Perpetual/Delivery
• adlAlert.USDC for USDC Perpetual/Delivery
• adlAlert.inverse for Inverse contracts

Fields

topic: String

The WebSocket topic for the event (e.g., “adlAlert.USDT”, “adlAlert.USDC”, “adlAlert.inverse”).

Specifies the data stream for the ADL alert update. Bots use this to determine which contract group the update belongs to.

event_type: String

The event type (e.g., “snapshot”).

ADL alert updates are typically snapshot type, containing the full current state.

timestamp: u64

The timestamp of the event in milliseconds.

Indicates when the ADL alert update was generated by the system. Bots use this to ensure data freshness and time-based analysis.

data: Vec<ADLAlertWebsocketItem>

The ADL alert data.

Contains a list of ADL alert items. Each item represents ADL alert information for a specific trading pair.

Implementations

impl ADLAlertUpdate

pub fn contract_group(&self) -> Option<&str>

Returns the contract group from the topic.

Extracts the contract group identifier from the WebSocket topic. Examples:

• “adlAlert.USDT” -> “USDT”
• “adlAlert.USDC” -> “USDC”
• “adlAlert.inverse” -> “inverse”

pub fn is_snapshot(&self) -> bool

Returns true if this is a snapshot update.

Snapshot updates contain the full ADL alert state and should replace the local state for the corresponding contract group.

pub fn timestamp_datetime(&self) -> DateTime<Utc>

Returns the timestamp as a chrono DateTime.

pub fn age_ms(&self) -> u64

Returns the age of the update in milliseconds.

Calculates how old this update is relative to the current time.

pub fn is_stale(&self) -> bool

Returns true if the update is stale (older than 2 seconds).

Since ADL alert updates are pushed every 1 second, data older than 2 seconds might be considered stale for real-time trading decisions.

pub fn count(&self) -> usize

Returns the number of ADL alert items in this update.

pub fn is_empty(&self) -> bool

Returns true if there are no ADL alert items in this update.

pub fn find_by_symbol(&self, symbol: &str) -> Option<&ADLAlertWebsocketItem>

Finds an ADL alert item for a specific symbol.

Returns the first matching ADL alert item for the given symbol.

pub fn filter_by_coin(&self, coin: &str) -> Vec<&ADLAlertWebsocketItem>

Finds all ADL alert items for a specific coin.

pub fn triggered_items(&self) -> Vec<&ADLAlertWebsocketItem>

Returns all ADL alert items where any ADL condition is triggered.

pub fn stopped_items(&self) -> Vec<&ADLAlertWebsocketItem>

Returns all ADL alert items where all ADL conditions are stopped.

pub fn count_triggered(&self) -> usize

Returns the number of ADL alert items with triggered conditions.

pub fn count_stopped(&self) -> usize

Returns the number of ADL alert items with stopped conditions.

pub fn total_balance(&self) -> f64

Returns the total balance across all ADL alert items.

pub fn average_pnl_ratio(&self) -> Option<f64>

Returns the average PnL ratio across all ADL alert items.

pub fn min_balance(&self) -> Option<f64>

Returns the minimum balance among all ADL alert items.

pub fn max_balance(&self) -> Option<f64>

Returns the maximum balance among all ADL alert items.

pub fn most_at_risk_item(&self) -> Option<&ADLAlertWebsocketItem>

Returns the item with the lowest balance (most at risk).

pub fn least_at_risk_item(&self) -> Option<&ADLAlertWebsocketItem>

Returns the item with the highest balance (least at risk).

pub fn to_summary_string(&self) -> String

Returns a summary string for this ADL alert update.

pub fn is_valid_for_trading(&self) -> bool

Validates the update for trading use.

Returns true if:

1. The update is not stale (≤ 2 seconds old)
2. There is at least one ADL alert item
3. The contract group can be extracted from the topic

pub fn latency_ms(&self, other_timestamp: u64) -> i64

Returns the update latency in milliseconds.

For comparing with other market data timestamps.

pub fn triggered_symbols(&self) -> Vec<String>

Returns all symbols that have ADL conditions triggered.

pub fn triggered_coins(&self) -> Vec<String>

Returns all coins that have ADL conditions triggered.

Trait Implementations

impl Clone for ADLAlertUpdate

fn clone(&self) -> ADLAlertUpdate

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ADLAlertUpdate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ADLAlertUpdate

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ADLAlertUpdate

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.