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

# lean live submit-order

[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 submit-order

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

## Introduction

Represents a command to submit an order to the algorithm.

```
$ lean live submit-order [OPTIONS] PROJECT
```

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

Sends a command to a running local live trading algorithm to submit a new order. The `--ticker`, `--market`, `--security-type`, `--order-type`, and `--quantity` options are required. For limit and stop orders, provide the `--limit-price` and `--stop-price` options as applicable. You can attach a `--tag` to the order for tracking purposes.

The algorithm must already be running via [`lean live deploy`](https://www.quantconnect.com/docs/v2/lean-cli/api-reference/lean-live-deploy.md) before you use this command.

## Arguments

The `lean live submit-order` command expects the following arguments:

| Argument | Description |
| --- | --- |
| `<project>` | The path to the project directory or algorithm file in which you want to submit the order. |

## Options

The `lean live submit-order` command supports the following options:

| Option | Description |
| --- | --- |
| `--ticker <string>` | [required] |
| `--market <string>` | [required] |
| `--security-type <string>` | [required] |
| `--order-type <string>` | [required] |
| `--quantity <float>` | [required] |
| `--limit-price <float>` | The limit price of the order be submitted |
| `--stop-price <float>` | The stop price of the order to be submitted |
| `--tag <string>` | The tag to be attached to the order |
| `--lean-config <file>` | The Lean configuration file that should be used (defaults to the nearest lean.json) |
| `--verbose` | Enable debug logging |
| `--help` | Display the help text of the `lean live submit-order` command and exit |