ibapi 5.2.0

An unofficial Rust client for the Interactive Brokers TWS API. 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
56
57
58
59
60
61
62
63
64
65

#![allow(clippy::uninlined_format_args)]
//! Async subscription fan-out example
//!
//! Clones one market data subscription so two tasks read the same ticks.
//! Each clone has its own read position and sees every tick; TWS sees one
//! request. A clone dropped early ends only that reader: the request is
//! cancelled when the last clone is dropped. Here the printer stops after a
//! few ticks while the counter keeps reading until its deadline.
//!
//! # Usage
//!
//! ```bash
//! cargo run --example async_subscription_fan_out
//! ```

use std::time::Duration;

use ibapi::prelude::*;
use ibapi::subscriptions::Subscription;
use tokio::time::{timeout_at, Instant};

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

    let client = Client::connect("127.0.0.1:4002", 100).await?;
    println!("Connected to IB Gateway");

    let contract = Contract::stock("AAPL").build();
    let subscription = client.market_data(&contract).subscribe().await?;

    let deadline = Instant::now() + Duration::from_secs(10);
    let printer = tokio::spawn(read("printer", subscription.clone(), deadline, Some(5)));
    let counter = tokio::spawn(read("counter", subscription.clone(), deadline, None));
    // Only the readers' clones are left; the last one dropped cancels the request at TWS.
    drop(subscription);

    println!("printer read {} ticks", printer.await?);
    println!("counter read {} ticks", counter.await?);
    Ok(())
}

/// Reads up to `limit` ticks (printing them when limited), stopping at
/// `deadline` even if no tick arrives. Notices are logged at `warn`
/// (run with `RUST_LOG=warn` to see them).
async fn read(name: &'static str, subscription: Subscription<TickTypes>, deadline: Instant, limit: Option<usize>) -> usize {
    let mut ticks = subscription.filter_data();
    let mut count = 0;
    while limit.is_none_or(|limit| count < limit) {
        match timeout_at(deadline, ticks.next()).await {
            Ok(Some(Ok(tick))) => {
                count += 1;
                if limit.is_some() {
                    println!("[{name}] {tick:?}");
                }
            }
            Ok(Some(Err(e))) => {
                eprintln!("[{name}] error: {e}");
                break;
            }
            Ok(None) | Err(_) => break,
        }
    }
    count
}