Skip to main content

nautilus_trading/examples/actors/imbalance/
mod.rs

1// -------------------------------------------------------------------------------------------------
2//  Copyright (C) 2015-2026 Nautech Systems Pty Ltd. All rights reserved.
3//  https://nautechsystems.io
4//
5//  Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6//  You may not use this file except in compliance with the License.
7//  You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9//  Unless required by applicable law or agreed to in writing, software
10//  distributed under the License is distributed on an "AS IS" BASIS,
11//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12//  See the License for the specific language governing permissions and
13//  limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16//! Order book imbalance actor.
17//!
18//! Subscribes to order book deltas for a set of instruments and tracks the
19//! cumulative bid/ask quoted volume. For each batch of deltas, sums the
20//! resting size at each updated price level per side and computes:
21//!
22//! `imbalance = (bid_volume - ask_volume) / (bid_volume + ask_volume)`
23//!
24//! The result ranges from -1.0 (all volume on the ask side) to +1.0 (all
25//! volume on the bid side). This measures which side of the book receives
26//! more quoted volume across updates, not the incremental change in volume.
27//! In a betting exchange context, bids correspond to "back" orders and asks
28//! to "lay" orders.
29
30pub mod actor;
31pub mod config;
32
33#[cfg(test)]
34mod tests;
35
36pub use actor::{BookImbalanceActor, ImbalanceState};
37pub use config::BookImbalanceActorConfig;