ibapi 3.0.0

A Rust implementation of the Interactive Brokers TWS API, providing a reliable and user friendly interface for TWS and IB Gateway. Designed with a focus on simplicity and performance.
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

#![allow(clippy::uninlined_format_args)]
//! Example demonstrating the canonical fluent order path with concurrent monitoring.
//!
//! - `client.order(&contract).buy(qty).limit(price).submit().await` is the canonical
//!   single-call submit. `submit()` allocates the order id internally and uses
//!   fire-and-forget delivery.
//! - All-order monitoring flows through `client.order_update_stream()`; this example
//!   spawns a single background task that reads from it.

use ibapi::prelude::*;
use std::error::Error;
use std::sync::Arc;

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

    // Connect to IB Gateway or TWS.
    let client = Arc::new(Client::connect("127.0.0.1:4002", 100).await?);
    println!("Connected to server version {}", client.server_version());

    // Spawn a background task to monitor all order updates before submitting.
    let monitor_client = client.clone();
    let monitor_handle = tokio::spawn(async move {
        let stream = match monitor_client.order_update_stream().await {
            Ok(s) => s,
            Err(e) => {
                eprintln!("failed to open order update stream: {e:?}");
                return;
            }
        };
        let mut stream = stream.filter_data();
        while let Some(update) = stream.next().await {
            match update {
                Ok(OrderUpdate::OrderStatus(status)) => {
                    println!(
                        "[Monitor] order {} status: {} filled {}/{}",
                        status.order_id,
                        status.status,
                        status.filled,
                        status.filled + status.remaining
                    );
                }
                Ok(OrderUpdate::OpenOrder(o)) => {
                    println!(
                        "[Monitor] open order {}: {} {} of {}",
                        o.order_id, o.order.action, o.order.total_quantity, o.contract.symbol
                    );
                }
                Ok(OrderUpdate::ExecutionData(e)) => {
                    println!(
                        "[Monitor] execution: order {} {} {} @ {}",
                        e.execution.order_id, e.execution.side, e.execution.shares, e.execution.price
                    );
                }
                Ok(OrderUpdate::CommissionReport(r)) => {
                    println!("[Monitor] commission: ${} for {}", r.commission, r.execution_id);
                }
                Err(e) => {
                    eprintln!("[Monitor] error: {e:?}");
                    break;
                }
            }
        }
    });
    tokio::time::sleep(tokio::time::Duration::from_millis(100)).await;

    let contract = Contract::stock("AAPL").build();

    // Submit a limit buy via the fluent path.
    let order_id = client.order(&contract).buy(100).limit(150.0).submit().await?;
    println!("Submitted order: {order_id}");

    // Submit two more orders concurrently using try_join!.
    let (order_id1, order_id2) = tokio::try_join!(
        client.order(&contract).buy(50).limit(149.0).submit(),
        client.order(&contract).sell(75).limit(151.0).submit(),
    )?;
    println!("Submitted orders: {order_id1}, {order_id2}");

    // Let the monitor task observe updates for up to 30 seconds, then abort it.
    let abort = monitor_handle.abort_handle();
    let _ = tokio::time::timeout(tokio::time::Duration::from_secs(30), monitor_handle).await;
    abort.abort();

    println!("\nExample complete");
    Ok(())
}