Create order
create_orderCreate and preview multi-leg orders for equities, options, futures, or crypto. Use dry-run to check fees and buying-power effect before submitting.
Instructions
Create an order with 1-4 legs (equity, options, futures, crypto). By default this is a DRY RUN that returns the order preview with buying-power effect, fees, and warnings WITHOUT placing it. Set dry_run=false to actually submit the order. Always dry-run first and confirm with the user before submitting a live order.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_number | Yes | The account number | |
| legs | Yes | Order legs | |
| order_type | No | Order type (default Limit) | |
| time_in_force | No | Time in force (default Day) | |
| price | No | Limit price as a decimal string, e.g. '1.50'. Required for Limit and Stop Limit orders. For multi-leg orders this is the net price | |
| price_effect | No | Whether the price is paid (Debit) or received (Credit). Inferred for single-leg orders; required for multi-leg limit orders | |
| stop_trigger | No | Stop trigger price. Required for Stop and Stop Limit orders | |
| gtc_date | No | Expiration date YYYY-MM-DD, required when time_in_force is GTD | |
| value | No | Notional dollar amount for Notional Market orders, e.g. '10.00' | |
| value_effect | No | Value effect for Notional Market orders | |
| dry_run | No | If true (the default), preview the order without submitting it |