{"record":{"id":"0e0323a9562cc0ba","repo":"nautechsystems/nautilus_trader","slug":"invalid-futures-kline-negative-trade-count","errorCode":null,"errorMessage":"invalid Futures kline {} negative trade count","messagePattern":"invalid Futures kline (.+?) negative trade count","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/adapters/binance/src/futures/http/client.rs","lineNumber":3320,"sourceCode":"        .taker_buy_base_volume\n        .parse::<Decimal>()\n        .map_err(|e| {\n            anyhow::anyhow!(\n                \"invalid Futures kline {} taker buy base volume: {e}\",\n                kline.open_time\n            )\n        })?;\n    let taker_buy_quote_volume = kline\n        .taker_buy_quote_volume\n        .parse::<Decimal>()\n        .map_err(|e| {\n            anyhow::anyhow!(\n                \"invalid Futures kline {} taker buy quote volume: {e}\",\n                kline.open_time\n            )\n        })?;\n    let count = u64::try_from(kline.num_trades).map_err(|_| {\n        anyhow::anyhow!(\n            \"invalid Futures kline {} negative trade count\",\n            kline.open_time\n        )\n    })?;\n\n    Ok(BinanceBar::new(\n        bar_type,\n        open,\n        high,\n        low,\n        close,\n        volume,\n        quote_volume,\n        count,\n        taker_buy_base_volume,\n        taker_buy_quote_volume,\n        ts_event,\n        ts_init,","sourceCodeStart":3302,"sourceCodeEnd":3338,"githubUrl":"https://github.com/nautechsystems/nautilus_trader/blob/18893faf8b356be3320add8de2f861b0b647cf06/crates/adapters/binance/src/futures/http/client.rs#L3302-L3338","documentation":"Raised when kline.num_trades is negative and cannot be converted into the unsigned u64 count used by BinanceBar. The parser uses u64::try_from and rejects negative trade counts as invalid, since a trade count can never be negative. This normally indicates a corrupted or fabricated payload rather than genuine exchange data.","triggerScenarios":"Futures kline response with num_trades < 0 (e.g. i64 underflow in a faulty mock, deserialization artifact, or hand-crafted fixture); triggered at client.rs:3320 during kline conversion.","commonSituations":"Custom mocks generating random signed integers for num_trades, buggy local proxies rewriting payloads, or misaligned deserialization producing wrong values.","solutions":["Inspect the raw payload's num_trades for the reported open_time; a negative value is never valid Binance data.","Fix any local mock/proxy generating the field to emit a non-negative integer.","Check for deserialization type mismatches (field read into a wrong-width signed type).","Skip the offending candle and log if the source is untrusted."],"exampleFix":"// before (mock)\nnum_trades: -5,\n// after\nnum_trades: 5u64,\n","handlingStrategy":"validation","validationCode":"if kline.num_trades < 0 {\n    return Err(format!(\"negative num_trades in kline {}: {}\", kline.open_time, kline.num_trades));\n}","typeGuard":null,"tryCatchPattern":"match convert_kline(&kline) {\n    Ok(bar) => emit(bar),\n    Err(e) if e.to_string().contains(\"negative trade count\") => {\n        log::error!(\"corrupt payload, dropping candle: {e}\");\n    }\n    Err(e) => return Err(e.into()),\n}","preventionTips":["Treat negative counts as data corruption; alert rather than retry blindly.","Use u64 in mocks/fixtures for count fields.","Add schema validation on ingested payloads from untrusted sources."],"tags":["binance","futures","kline","trade-count","value-out-of-range"],"backgroundTag":"value-out-of-range","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"}