API Reference
lean cloud live deploy
Description
Starts live trading for a cloud project.
Before starting live trading, the CLI shows an interactive wizard letting you configure the brokerage, the live node, and the notifications.
After starting live trading, the CLI displays a URL to the live results.
You can use the --open
flag to automatically open this URL in the browser once the deployment starts.
If you specify the --brokerage
option, the interactive wizard is skipped and the command runs in non-interactive mode.
In this mode, the command doesn't prompt for input or confirmation and reads all configuration from the provided command-line options.
In non-interactive mode, all options specific to the selected brokerage become required, as well as --node
, --auto-restart
, --notify-order-events
, and --notify-insights
.
The following options are required for each brokerage in non-interactive mode:
--brokerage | Required Options |
---|---|
"Paper Trading" | N/A |
"Binance" | --binance-exchange-name |
--binance-api-key or --binanceus-api-key | |
--binance-api-secret or --binanceus-api-secret | |
--binance-use-testnet | |
"Bitfinex" | --bitfinex-api-key |
--bitfinex-api-secret | |
"Coinbase Pro" | --gdax-api-key |
--gdax-api-secret | |
--gdax-passphrase | |
--gdax-use-sandbox | |
"Interactive Brokers" | --ib-user-name |
--ib-account | |
--ib-password | |
--ib-data-feed | |
"Kraken" | --kraken-api-key |
--kraken-api-secret | |
--kraken-verification-tier | |
"OANDA" | --oanda-account-id |
--oanda-access-token | |
--oanda-environment | |
"Samco" | --samco-client-id |
--samco-client-password | |
--samco-year-of-birth | |
--samco-product-type | |
--samco-trading-segment | |
"TDAmeritrade" | --tdameritrade-api-key |
--tdameritrade-access-token | |
--tdameritrade-account-number | |
"Terminal Link" | --terminal-link-server-auth-id |
--terminal-link-environment | |
--terminal-link-server-host | |
--terminal-link-server-port | |
--terminal-link-emsx-broker | |
--terminal-link-openfigi-api-key | |
"Tradier" | --tradier-account-id |
--tradier-access-token | |
--tradier-environment | |
"Trading Technologies" | --tt-user-name |
--tt-session-password | |
--tt-account-name | |
--tt-rest-app-key | |
--tt-rest-app-secret | |
--tt-rest-environment | |
--tt-order-routing-sender-comp-id | |
"Zerodha" | --zerodha-api-key |
--zerodha-access-token | |
--zerodha-product-type | |
--zerodha-trading-segment | |
--zerodha-history-subscription |
If you omit some of the required brokerage options when running in non-interactive mode, the CLI uses the option values in your LEAN configuration file.
Example non-interactive usage:
$ lean cloud live deploy "My Project" \ --brokerage "Paper Trading" \ --node "My Node" \ --auto-restart yes --notify-order-events no \ --notify-insights no \ --push \ --open
If you have a local copy of the cloud project, you can use the --push
option to push local modifications to the cloud before starting live trading.
Options
The lean cloud live deploy
command supports the following options:
Option | Description |
---|---|
--brokerage <value> | The brokerage to use when running in non-interactive mode. |
--binance-exchange-name <value> | Binance , BinanceUS , Binance-USDM-Futures , or Binance-COIN-Futures |
--binance-api-key <value> | Your Binance API key, which you can generate on the API Management page on the Binance website. |
--binanceus-api-key <value> | Your Binance US API key, which you can generate on the API Management page on the Binance US website. |
--binance-api-secret <value> | Your Binance API secret. |
--binanceus-api-secret <value> | Your Binance US API secret. |
--binance-use-testnet <value> | live to use the production environment or paper to use the testnet. |
--bitfinex-api-key <value> | Your Bitfinex API key, which you can generate on the API Management page on the Bitfinex website. |
--bitfinex-api-secret <value> | Your Bitfinex API secret. |
--gdax-api-key <value> | Your Coinbase API key, which you can generate on the API settings page on the Coinbase website. |
--gdax-api-secret <value> | Your Coinbase API secret. |
--gdax-passphrase <value> | Your Coinbase API passphrase. |
--gdax-use-sandbox <value> | live to use the live trading environment or paper to use the sandbox. |
--ib-user-name <value> | Your Interactive Brokers username (example: trader777). |
--ib-account <value> | Your Interactive Brokers account Id (example: DU1234567). |
--ib-password <value> | Your Interactive Brokers password. |
--ib-data-feed <boolean> | Whether the Interactive Brokers price data feed must be used instead of the one from QuantConnect (yes or no ). |
--kraken-api-key <value> | Your Kraken API key, which you can find on the API Management Settings page on the Kraken website. |
--kraken-api-secret <value> | Your Kraken API secret. |
--kraken-verification-tier <value> | Your Kraken verification tier (Starter , Intermediate , or Pro ). For more information about verification tiers, see Verification levels explained on the Kraken website. |
--oanda-account-id <value> | Your OANDA account id, which you can find on your Account Statement page on the OANDA website. |
--oanda-access-token <value> | Your OANDA API token, which you can generate on the Manage API Access page on the OANDA website. |
--oanda-environment <value> | Practice to trade on fxTrade Practice or Trade to trade on fxTrade. |
--samco-client-id <value> | Your Samco account Client ID. |
--samco-client-password <value> | Your Samco account password. |
--samco-year-of-birth <value> | Your year of birth (YYYY) registered with Samco. |
--samco-product-type <value> | The product type, which must be mis if you are targeting intraday products, cnc if you are targeting delivery products, or nrml if you are targeting carry forward products. |
--samco-trading-segment <value> | The trading segment, which must be equity if you are trading equities on NSE or BSE, or commodity if you are trading commodities on MCX. |
--tdameritrade-api-key <value> | Your TDAmeritrade API key. |
--tdameritrade-access-token <value> | Your TDAmeritrade OAuth Access Token. |
--tdameritrade-account-number <value> | Your TDAmeritrade account number. |
--terminal-link-server-auth-id <value> | Your unique user identifier (UUID). The UUID is a unique integer identifier that's assigned to each Bloomberg Anywhere user. If you don't know your UUID, contact Bloomberg. |
--terminal-link-environment <value> | The environment to run in. Production or Beta . |
--terminal-link-server-host <value> | The public IP address of the SAPI AWS server. |
--terminal-link-server-port <value> | The port where SAPI is listening. The default port is 8194. |
--terminal-link-emsx-broker <value> | The EMSX broker to use. |
--terminal-link-openfigi-api-key <value> | The OpenFIGI API key to use for mapping options. |
--tradier-account-id <value> | Your Tradier account id, which you can find on your Settings > API Access page on the Tradier website. |
--tradier-access-token <value> | Your Tradier access token. |
--tradier-environment <value> | live to use the live environment or paper to use the developer sandbox. |
--tt-user-name <value> | Your Trading Technologies username. |
--tt-session-password <value> | Your Trading Technologies session password. |
--tt-account-name <value> | Your Trading Technologies account name. |
--tt-rest-app-key <value> | Your Trading Technologies REST app key. |
--tt-rest-app-secret <value> | Your Trading Technologies REST app secret. |
--tt-rest-environment <value> | The REST environment in which to run. |
--tt-order-routing-sender-comp-id <value> | The order routing sender comp Id to use. |
--zerodha-api-key <value> | Your Kite Connect API key. |
--zerodha-access-token <value> | Your Zerodha access token. |
--zerodha-product-type <value> | The product type, which must be mis if you are targeting intraday products, cnc if you are targeting delivery products, or nrml if you are targeting carry forward products. |
--zerodha-trading-segment <value> | The trading segment, which must be equity if you are trading equities on NSE or BSE, or commodity if you are trading commodities on MCX. |
--zerodha-history-subscription <boolean> | Whether you have a history API subscription for Zerodha. |
--node <value> | The name or Id of the live node to run on. |
--auto-restart <boolean> | Whether automatic algorithm restarting must be enabled. |
--notify-order-events <boolean> | Whether notifications must be sent for order events. |
--notify-insights <boolean> | Whether notifications must be sent for emitted insights. |
--notify-emails <email> <subject> | A comma-separated list of "email:subject" pairs configuring email-notifications. |
--notify-webhooks <url> <headers> | A comma-separated list of "url:HEADER_1=VALUE_1:HEADER_2=VALUE_2:etc" pairs configuring webhook-notifications. |
--notify-sms <value> | A comma-separated list of phone numbers configuring SMS notifications. |
--notify-telegram <value> | A comma-separated list of "user/group Id:token(optional)" pairs configuring telegram notifications. |
--live-cash-balance <value> | A comma-separated list of "currency:amount" pairs that define the initial cash balance. |
--live-holdings <value> | A comma-separated list of "symbol:symbolId:quantity:averagePrice" pairs that define the initial portfolio holdings. For example, "GOOG:GOOCV VP83T1ZUHROL:10:50.0" . |
--push | Push local modifications to the cloud before starting live trading. |
--open | Automatically open the live results in the browser once the deployment starts. |
--verbose | Enable debug logging. |
--help | Display the help text of the lean cloud live deploy command and exit. |