{"record":{"id":"257686bb3dec8755","repo":"nautechsystems/nautilus_trader","slug":"stream-client-not-connected","errorCode":null,"errorMessage":"Stream client not connected","messagePattern":"Stream client not connected","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/adapters/betfair/src/data.rs","lineNumber":1121,"sourceCode":"        self.subscribed_market_ids.clear();\n\n        log::info!(\"Betfair data client disconnected: {}\", self.client_id);\n        Ok(())\n    }\n\n    fn subscribe_book_deltas(&mut self, cmd: SubscribeBookDeltas) -> anyhow::Result<()> {\n        let instrument_id = cmd.instrument_id;\n        let market_id = extract_market_id(&instrument_id)?;\n\n        if !self.subscribed_market_ids.insert(market_id.clone()) {\n            log::debug!(\"Book deltas already subscribed for market {market_id}\");\n            return Ok(());\n        }\n\n        let stream_client = Arc::clone(\n            self.stream_client\n                .as_ref()\n                .ok_or_else(|| anyhow::anyhow!(\"Stream client not connected\"))?,\n        );\n\n        let all_ids: Vec<String> = self.subscribed_market_ids.iter().cloned().collect();\n\n        let market_filter = StreamMarketFilter {\n            market_ids: Some(all_ids),\n            ..Default::default()\n        };\n\n        let data_filter = MarketDataFilter {\n            fields: Some(vec![\n                MarketDataFilterField::ExAllOffers,\n                MarketDataFilterField::ExTraded,\n                MarketDataFilterField::ExTradedVol,\n                MarketDataFilterField::ExLtp,\n                MarketDataFilterField::ExMarketDef,\n                MarketDataFilterField::SpTraded,\n                MarketDataFilterField::SpProjected,","sourceCodeStart":1103,"sourceCodeEnd":1139,"githubUrl":"https://github.com/nautechsystems/nautilus_trader/blob/18893faf8b356be3320add8de2f861b0b647cf06/crates/adapters/betfair/src/data.rs#L1103-L1139","documentation":"subscribe_book_deltas requires the Betfair stream client to be present. If self.stream_client is None (set only after a successful connect), the call fails immediately with 'Stream client not connected' instead of attempting to subscribe.","triggerScenarios":"Calling subscribe_book_deltas before connect() succeeded, after disconnect() cleared stream_client, or after a failed reconnect cleared the client.","commonSituations":"Subscribing during startup before the connection handshake finished; resubscribing after a stream drop without reconnecting; ordering issues where subscription requests arrive ahead of the connect future.","solutions":["Ensure connect() completed successfully before subscribing","Guard with an Option check / await readiness instead of assuming the client exists","Reconnect after any disconnect before retrying the subscription"],"exampleFix":"// before\nif !market_client.is_connected().await { market_client.connect().await?; }\nmarket_client.subscribe_book_deltas(...).await?;\n// after — explicit readiness check\nif market_client.stream_ready() {\n    market_client.subscribe_book_deltas(...).await?;\n} else {\n    log::warn!(\"stream not connected; skipping subscribe\");\n}","handlingStrategy":"validation","validationCode":"if market_client.stream_client().is_none() {\n    market_client.connect().await?;\n}","typeGuard":"fn stream_ready(client: &BetfairMarketDataClient) -> bool {\n    client.stream_client().is_some()\n}","tryCatchPattern":"match market_client.subscribe_book_deltas(...).await {\n    Err(e) if e.to_string().contains(\"Stream client not connected\") => {\n        market_client.connect().await?;\n        market_client.subscribe_book_deltas(...).await?;\n    }\n    other => other?,\n}","preventionTips":["Always connect before subscribing","Track connection state in the actor's on_start","Reconnect on stream drop before resubscribing"],"tags":["rust","betfair","state-error","subscription"],"backgroundTag":"invalid-state-transition","analyzedSha":"18893faf8b356be3320add8de2f861b0b647cf06","analyzedAt":"2026-09-08T20:49:34.690Z","contentChangedAt":"2026-09-08T20:49:34.690Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}