---
title: "lean live"
description: "API reference for the command `lean live` in command line console."
canonical: https://www.quantconnect.com/docs/v2/lean-cli/api-reference/lean-live
markdown: https://www.quantconnect.com/docs/v2/lean-cli/api-reference/lean-live.md
language: python
source: https://github.com/QuantConnect/Documentation/tree/master/05%20Lean%20CLI/99%20API%20Reference/33%20lean%20live
modified: 2026-11-04
index: https://www.quantconnect.com/llms.txt
---

# lean live

[Documentation](https://www.quantconnect.com/docs/v2.md) > [Lean CLI](https://www.quantconnect.com/docs/v2/lean-cli.md) > [API Reference](https://www.quantconnect.com/docs/v2/lean-cli/api-reference.md) > lean live

> Code examples are shown in Python. Append `?lang=csharp` to this URL for the C# version of this page.

## Introduction

Interact with the local machine.

```
$ lean live [OPTIONS] COMMAND [ARGS]...
```

To use the CLI, you must be a member in an [organization](https://www.quantconnect.com/docs/v2/cloud-platform/organizations/tier-features.md) on a paid tier.

## Description

The `lean live` command provides subcommands for managing live trading on your local machine using Docker. Use `lean live deploy` to start a new local live deployment, `lean live stop` to stop a running deployment, and `lean live liquidate` to liquidate positions in a running deployment.

You can also interact with a running algorithm using `lean live add-security`, `lean live submit-order`, `lean live cancel-order`, `lean live update-order`, and `lean live command`. See the subcommand pages for full details on each operation.

## Options

The `lean live` command supports the following options:

| Option | Description |
| --- | --- |
| `--help` | Display the help text of the `lean live` command and exit |

## Commands

The `lean live` command expects the following arguments:

| Argument | Description |
| --- | --- |
| `add-security` | Represents a command to add a security to the algorithm |
| `cancel-order` | Represents a command to cancel a specific order by id |
| `command` | Send a command to a local running live trading project |
| `deploy` | Start live trading a project locally using Docker |
| `liquidate` | Liquidate the given symbol from the latest deployment of the given project |
| `stop` | Stop an already running local live trading project |
| `submit-order` | Represents a command to submit an order to the algorithm |
| `update-order` | Represents a command to update a specific order by id |