API Reference

lean cloud live

Introduction

Start live trading for a project in the cloud.

$ lean cloud live <project> [options]

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:

--brokerageRequired Options
"Paper Trading"N/A
"Binance"--binance-api-key
--binance-api-secret
--binance-environment
"Bitfinex"--bitfinex-api-key
--bitfinex-api-secret
"Coinbase Pro"--gdax-api-key
--gdax-api-secret
--gdax-passphrase
--gdax-environment
"FTX"--ftx-api-key
--ftx-api-secret
--ftx-account-tier
--ftx-exchange-name
"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
"Tradier"--tradier-account-id
--tradier-access-token
--tradier-environment

Example non-interactive usage:

$ lean cloud live "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.

Arguments

The lean cloud live command expects the following arguments:

ArgumentDescription
<project>The name or id of the project to start live trading.

Options

The lean cloud live command supports the following options:

OptionDescription
--brokerage <value>The brokerage to use when running in non-interactive mode.
--binance-api-key <value>Your Binance API key, which you can generate on your API Settings Management page on the Binance website if you want to use the production environment or on Binance Testnet if you want to use the demo environment.
--binance-api-secret <value>Your Binance API secret.
--binance-environment <value>demo if you want to use the testnet, or real if you want to use the production environment.
--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 Pro API key, which you can generate on the API settings page on the Coinbase Pro website.
--gdax-api-secret <value>Your Coinbase Pro API secret.
--gdax-passphrase <value>Your Coinbase Pro API passphrase.
--gdax-environment <value>paper if you want to use the sandbox, or live if you want to use the production environment.
--ftx-api-key <value>Your FTX API key, which you can create on your Profile page on the FTX or FTX US website.
--ftx-api-secret <value>Your FTX API secret.
--ftx-account-tier <value>Your FTX account tier (example: Tier1). To find your account tier, see your Profile page on the FTX or FTX US website.
--ftx-exchange-name <value>ftx if you want to trade on FTX, or ftxus if you want to trade on FTX US.
--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. For more information about verification tiers, see Verification levels explained on the Kraken website. Enter 1 for the Starter tier, 2 for the Intermediate tier, or 3 for the Pro tier.
--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>demo if you want to trade on fxTrade Practice, or real if you want to trade on fxTrade.
--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>demo if you want to use the developer sandbox, or real if you want to use the live trading environment.
--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.
--pushPush local modifications to the cloud before starting live trading.
--openAutomatically open the live results in the browser once the deployment starts.
--verboseEnable debug logging.
--helpDisplay the help text of the lean cloud live command and exit.

You can also see our Videos. You can also get in touch with us via Discord.

Did you find this page helpful?

Contribute to the documentation: