{"record":{"id":"afa6e05ccbddef90","repo":"nautechsystems/nautilus_trader","slug":"invalid-callback-rate-raw-multiplication-over","errorCode":null,"errorMessage":"invalid callback_rate='{raw}': multiplication overflow","messagePattern":"invalid callback_rate='(.+?)': multiplication overflow","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"crates/adapters/binance/src/futures/http/models.rs","lineNumber":1779,"sourceCode":"    let decimal = parse_required_decimal(raw, field)?;\n    if decimal <= Decimal::ZERO {\n        return Ok(None);\n    }\n\n    Price::from_decimal_dp(decimal, precision)\n        .map(Some)\n        .map_err(|e| anyhow::anyhow!(\"invalid {field} precision: {e}\"))\n}\n\nfn parse_callback_rate_basis_points(raw: &str) -> anyhow::Result<Option<Decimal>> {\n    let rate = parse_required_decimal(raw, \"callback_rate\")?;\n    if rate <= Decimal::ZERO {\n        return Ok(None);\n    }\n\n    rate.checked_mul(Decimal::from(100))\n        .map(Some)\n        .ok_or_else(|| anyhow::anyhow!(\"invalid callback_rate='{raw}': multiplication overflow\"))\n}\n\nfn parse_working_type(working_type: Option<BinanceWorkingType>) -> TriggerType {\n    match working_type {\n        Some(BinanceWorkingType::ContractPrice) => TriggerType::LastPrice,\n        Some(BinanceWorkingType::MarkPrice) => TriggerType::MarkPrice,\n        Some(BinanceWorkingType::Unknown) | None => TriggerType::Default,\n    }\n}\n\nfn requires_algo_trigger_price(order_type: BinanceFuturesOrderType) -> bool {\n    matches!(\n        order_type,\n        BinanceFuturesOrderType::Stop\n            | BinanceFuturesOrderType::StopMarket\n            | BinanceFuturesOrderType::TakeProfit\n            | BinanceFuturesOrderType::TakeProfitMarket\n            | BinanceFuturesOrderType::TrailingStopMarket","sourceCodeStart":1761,"sourceCodeEnd":1797,"githubUrl":"https://github.com/nautechsystems/nautilus_trader/blob/18893faf8b356be3320add8de2f861b0b647cf06/crates/adapters/binance/src/futures/http/models.rs#L1761-L1797","documentation":"Raised when converting a parsed callback_rate decimal to a percentage fails because Decimal checked multiplication overflows (rate * 100 cannot be represented). callback_rate (Binance take-profit/stop orders) is stored in basis-point-compatible form; the parser multiplies by 100 and rejects values extreme enough to overflow Decimal. Indicates a corrupted or absurd callback_rate string rather than normal market data.","triggerScenarios":"parse_callback_rate_basis_points in futures/http/models.rs:1779 receives a raw string that parses to a finite decimal but overflows when multiplied by 100 — e.g. values near Decimal::MAX from a bad fixture, mocked endpoint, or corrupted response.","commonSituations":"Hand-written test fixtures with sentinel values like \"99999999999999999999999999999999999\", proxy/mock bugs emitting garbage numbers, or upstream schema changes changing the callback_rate unit.","solutions":["Inspect the raw callback_rate string reported in the error; valid Binance values are small percentages (e.g. \"1.0\"–\"5.0\" range, 0.1%–5% limits).","Fix fixtures/mocks to emit realistic callback rates.","Validate the range (Binance enforces 0.1 <= rate <= 5 for futures TP/SL) before conversion.","If the unit changed upstream, update the conversion instead of relying on *100."],"exampleFix":"// before (fixture)\ncallback_rate: \"99999999999999999999999999999999999\"\n// after\ncallback_rate: \"1.5\" // 1.5%","handlingStrategy":"validation","validationCode":"let rate: Decimal = raw.parse()?;\nif rate < Decimal::new(1, 1) || rate > Decimal::new(5, 0) {\n    return Err(format!(\"callback_rate {raw} outside Binance range 0.1..5\"));\n}","typeGuard":null,"tryCatchPattern":"match parse_callback_rate_basis_points(&raw) {\n    Ok(Some(pct)) => use(pct),\n    Ok(None) => {},\n    Err(e) if e.to_string().contains(\"multiplication overflow\") => {\n        log::error!(\"implausible callback_rate, rejecting: {e}\");\n    }\n    Err(e) => return Err(e.into()),\n}","preventionTips":["Validate callback_rate against Binance's 0.1%-5% allowed range before conversion.","Use realistic values in fixtures and mocks.","Investigate any overflow as corrupted upstream data, not a numeric edge case."],"tags":["binance","futures","callback-rate","decimal-overflow"],"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"}