Suggest Order (order to authorize — the user decides)
suggest_orderPROPOSE a trade for the user to authorize, instead of placing it yourself. You never move the user's money with this tool: you only create an "order to authorize" (entry, stop loss, take profit, expiration) and the USER authorizes its execution. Use it whenever you should not or cannot place trades directly — e.g. your policy does not allow executing real-money trades, or the user wants to review first. (To place an order directly and immediately, when allowed and requested, use execute_trade.) Get the broker's current price with get_quote first and compute entry, stop loss and take profit from it (a SELL LIMIT above the bid, a BUY LIMIT below the ask). For breakout entries use create_conditional_order.
What happens next depends on the user's own settings in TraderWAI: (1) No auto-execution for this symbol: TraderWAI notifies the user (email / browser) and the order waits in "Orders to authorize" until they authorize it, reject it, or it expires. Nothing is executed without their action. (2) The user enabled auto-execution for this symbol: TraderWAI executes it on their broker following the rules the user configured (account, size, daily limits), and notifies them.
Tell the user which case applies if you know it, and remind them they can automate a symbol from the notification. Provide concrete price levels as full numbers (e.g. 1.09542 / 95432.50) and an expiration. Available on all plans.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Brief trade rationale shown to the user | |
| source | No | Identifier of the AI making the suggestion (e.g. "claude", "fable") | |
| symbol | Yes | Trading symbol (e.g. EUR_USD). | |
| stopLoss | Yes | Stop loss price level (full price, no abbreviations) | |
| expiresAt | No | Absolute ISO 8601 expiration (overrides expiresInHours) | |
| orderType | Yes | LONG = buy, SHORT = sell | |
| confidence | No | Confidence 0-100 | |
| entryPrice | No | Reference/expected entry price (current market price for MARKET) | |
| limitPrice | No | Required for LIMIT orders: the desired entry price level | |
| takeProfit | Yes | Take profit price level (full price, no abbreviations) | |
| executionType | Yes | MARKET = at current price, LIMIT = at a specific price | |
| expiresInHours | No | Hours until the suggestion expires (1-72, default 24). Ignored if expiresAt is set | |
| riskRewardRatio | No | Computed risk:reward ratio |