Skip to content

aetelier_connect::synchronizers::event_sync

Market-event-aligned snapshot synchronizer.

Unlike the grid-based MarketSynchronizer, EventSynchronizer emits a MarketSnapshot each time a designated reference market event is received. Reference events are configurable and can be any combination of: new orderbook delta, new trade, or new liquidation — all originating from the exchange WSS feed.

Semantics

  • Orderbook is state-based: the most recent full snapshot is carried forward into every emitted MarketSnapshot.
  • Trades, liquidations are event-based: accumulated between consecutive reference events. Buffers are drained on emission.
  • Funding rate, open interest are state-based: the latest values are cloned into each emitted snapshot.

A snapshot is emitted only when: 1. A reference event arrives, and 2. At least one orderbook has been observed (the synchronizer is initialized).

Usage

use aetelier_connect::synchronizers::{EventSynchronizer, ReferenceEventType};

// Emit a snapshot on every orderbook delta:
let mut sync = EventSynchronizer::orderbook_only();

// Or on every trade and liquidation:
let mut sync = EventSynchronizer::new(vec![
    ReferenceEventType::Trade,
    ReferenceEventType::Liquidation,
]);

// Feed events as they arrive from the WSS stream:
sync.on_orderbook("BTCUSDT", ts_ns, orderbook);
sync.on_trade(trade);
sync.on_liquidation(liquidation);
sync.on_funding(funding_rate);
sync.on_open_interest(oi);

// At end of stream:
sync.finalize();
let snapshots: Vec<MarketSnapshot> = sync.drain();

Skeleton API reference

This page lists the public items in aetelier_connect::synchronizers::event_sync with a one-line summary each. Signatures and source live in the SDK repository.

Structs

Item Summary
EventSynchronizer Event-driven snapshot synchronizer.

Enums

Item Summary
ReferenceEventType Which market event type triggers snapshot emission.