Repository navigation
Description
lean cloud live deploy cannot create an Interactive Brokers (FIX) deployment. The cloud brokerage list the CLI builds from modules-1.14.json has one Interactive Brokers entry, InteractiveBrokersBrokerage (the IB Gateway integration: ib-user-name, ib-account, ib-password, ib-host, ib-port, ...). There is no InteractiveBrokersFixBrokerage module and no ib-fix-* option, in interactive or non-interactive mode, so a member who moved an IB account to the FIX integration (the route the Interactive Brokers docs now recommend for live accounts) can only deploy through the web wizard and loses scripted deployments.
The API side already supports it: /live/create accepts the InteractiveBrokersFixBrokerage module with ib-fix-account, ib-fix-user-name and ib-fix-linked-account (the IB user name whose Client Portal authorization the wizard stored), and live/auth0/read answers brokerage=InteractiveBrokersFixBrokerage with userId=<IB user name> by returning the linked accounts for that user name. The gap is in the CLI.
Reproduce
Lean CLI 1.0.233 (master fba6da7, 2026-10-27), modules-1.14.json fetched from https://cdn.quantconnect.com/cli/modules-1.14.json on 2026-10-31.
$ lean cloud live deploy "My Project" --brokerage "Interactive Brokers (FIX)" --ib-fix-account U1234567 --ib-fix-user-name someuser --node L-MICRO --auto-restart no --notify-order-events no --notify-insights no
Error: No such option '--ib-fix-account'. (Did you mean one of: '--eze-trading-account', '--ib-account', '--terminal-link-emsx-account'?)
$ lean cloud live deploy "My Project" --brokerage "Interactive Brokers (FIX)" --node L-MICRO --auto-restart no --notify-order-events no --notify-insights no
Error: Invalid value for '--brokerage': 'Interactive Brokers (FIX)' is not one of 'Paper Trading', 'Interactive Brokers', 'Tradier', 'Oanda', 'Bitfinex', 'Coinbase Advanced Trade', 'Binance', 'Zerodha', 'Samco', 'Terminal Link', 'Trading Technologies', 'Kraken', 'CharlesSchwab', 'Bybit', 'TradeStation', 'Alpaca', 'Tastytrade', 'Eze', 'dYdX', 'Webull', 'Public', 'ClearStreet'.
$ lean cloud live deploy --help | grep -- --ib-
--ib-user-name TEXT Your Interactive Brokers username
--ib-account TEXT Your Interactive Brokers account id
--ib-password TEXT Your Interactive Brokers password
--ib-host TEXT External Interactive Brokers Gateway Host
--ib-port TEXT External Interactive Brokers Gateway Port
--ib-weekly-restart-utc-time TEXT
--ib-financial-advisors-group-filter TEXT
InteractiveBrokersFixBrokerage as the --brokerage value fails the same way, and the interactive wizard offers the same 22 names.
Where
lean/models/__init__.py:20-26downloadsmodules-1.14.json;lean/models/cloud/__init__.py:21-33keeps the entries whoseplatformcontainscloudand whosetypecontainsbrokerageascloud_brokerages. The file has no FIX entry, solean/models/click_options.py:24-25never generates the options andlean/commands/cloud/live/deploy.py:290(non_interactive_config_build_for_name) cannot resolve the name.- The CLI already has the pattern a FIX entry needs: an
oauth-tokenconfiguration (lean/models/configuration.py:434-448,AuthConfiguration) withrequire-user-name: true, asCharlesSchwabBrokerageuses (charles-schwab-oauth-token+ acharles-schwab-account-numberchoice filtered on it).JsonModule.get_user_name()(lean/models/json_module.py:178-204) reads<prefix>-user-namefrom the options, and the Auth0 flow (json_module.py:311-330,lean/components/util/auth0_helper.py:19-44) callslive/auth0/readwithuserIdand offersaccountsfrom the response as the account choice.
Proposed change
- Add an
InteractiveBrokersFixBrokerageentry to the modules JSON (display idInteractive Brokers (FIX),platform: ["cloud"],type: ["brokerage"], minimum seat as the Gateway entry) with:ib-fix-oauth-token:type: oauth-token,require-user-name: true(so--ib-fix-user-nameis the IB user name the CLI authorizes with, matchingget_user_name()'s<prefix>-user-nameconvention);ib-fix-account:input-method: choice, filtered on the token, populated from theaccountsthe Auth0 read returns;- the settings sent to
/live/createmust includeib-fix-linked-accountset to the same IB user name (the factory requires it), so either the module maps it from the user name or the CLI adds it inget_settings()for this module.
- The Auth0 brokerage name the CLI sends is the lowercased display name (
json_module.py:318:self._display_name.lower()), which for the new entry would beinteractive brokers (fix);live/auth0/authorizeexpectsinteractivebrokersandlive/auth0/readacceptsinteractivebrokersfixbrokerage/interactivebrokersbrokerage. The CLI needs to send the module id (or an explicitauth0-brokeragefield from the JSON) rather than the display name, or the API needs the alias. - Document the new options on the
lean cloud live deploypage (today it lists the Gateway options only).
Untested: no diff, since the change spans the CDN modules file and the CLI.
Open questions
- Should
--ib-fix-user-namereuse the Gateway-style free text, or should the CLI require the user name to already be linked (the wizard's "+ Add Account" flow opens the IB login; the CLI'sauthorizeURL does the same withuserId)? - The paper-account rule (FIX does not support
DUaccounts) belongs in the module's validation.
Intercom conversation 215476644846297.
Activity
quantconnect-kronos commentedon Nov 1, 2026
Draft fix in #694. The other modules the CLI authorizes through OAuth (CharlesSchwab, TradeStation, Alpaca, Tastytrade) have a display name that, lowercased, is already the brokerage's authorization name, so they keep working unchanged. Interactive Brokers (FIX) is the only one whose display name differs; its modules json entry names
interactivebrokersthrough the new optionalauth0-brokeragekey. The entry itself is in the PR description, to publish with the release.