place_limit_order
Submit a limit order to buy or sell an instrument at a specified limit price. The order remains open until filled, cancelled, or expires, allowing you to control the execution price instead of using a market order.
Instructions
Submit a limit order that executes only when the instrument reaches your
target price. The order stays open until filled, cancelled, or expired.
Use this instead of a market order when you want to control the execution
price. Check fetch_all_orders afterward to monitor fill status.
Args:
ticker: Instrument ticker (e.g., 'AAPL_US_EQ'). Use search_instrument to find valid tickers.
quantity: Number of shares. Positive to buy, negative to sell.
limit_price: Maximum price to pay (buy) or minimum to accept (sell).
For example, 150.00 means "buy at 150 or lower".
time_validity: How long the order stays active. DAY (expires end of trading day)
or GOOD_TILL_CANCEL (stays open until filled or manually cancelled). Defaults to DAY.
Returns:
Order: The newly created limit order with its pending statusInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | ||
| quantity | Yes | ||
| limit_price | Yes | ||
| time_validity | No | DAY |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| ticker | Yes | ||
| type | No | ||
| status | No | ||
| quantity | No | ||
| filledQuantity | No | ||
| filledValue | No | ||
| limitPrice | No | ||
| stopPrice | No | ||
| strategy | No | ||
| value | No | ||
| creationTime | No |