ibapi 5.4.0

An unofficial Rust client for the Interactive Brokers TWS API: market data, orders, and account data, with async (Tokio) and blocking clients for TWS and IB Gateway.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

#![allow(clippy::uninlined_format_args)]
//! Example of subscribing to TWS display group events asynchronously
//!
//! Display Groups are a TWS-only feature (not available in IB Gateway).
//! They allow organizing contracts into color-coded groups in the TWS UI.
//!
//! To run this example:
//! ```bash
//! cargo run --example async_group_events
//! ```
//!
//! Make sure TWS is running with API connections enabled

use ibapi::prelude::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    env_logger::init();

    println!("Connecting to TWS...");

    // Display Groups require TWS (not IB Gateway)
    let client = Client::connect("127.0.0.1:7497", 100).await?;
    println!("Connected successfully!");

    // Visible groups, most used first; 1 is "Group 1" in TWS (Red).
    let groups = client.display_groups().await?;
    println!("Visible display groups: {:?}", groups);
    let Some(&group_id) = groups.first() else {
        eprintln!("No display groups visible in TWS");
        return Ok(());
    };

    println!("\nSubscribing to group events for group {}...", group_id);
    let mut subscription = client.subscribe_to_group_events(group_id).await?;

    println!("Listening for events. Change the contract in TWS group {} to see updates.", group_id);

    // DisplayGroupSubscription derefs to Subscription; deref-then-borrow before filter_data.
    let inner = &mut *subscription;
    while let Some(result) = inner.filter_data().next().await {
        match result {
            Ok(event) => {
                println!("Received group event: {:?}", event);
                println!("  Contract info: {}", event.contract_info);
            }
            Err(e) => {
                eprintln!("Error receiving group event: {e:?}");
                break;
            }
        }
    }

    Ok(())
}