Understanding the trading flow
BrokerBridge follows a six-stage pipeline. Each stage is deterministic and auditable. Nothing executes without your explicit approval.
Instant KPL chart analysis
You don't have to wait for the scanner. Drop a screenshot of any chart — from any platform — into the chat, or click Analyze Chart, and BrokerBridge reads it through its proprietary Key Price Levels (KPL) framework.
You get back the key levels, the current market structure, a directional bias, and a risk-defined entry, stop, and target — the same structured shape as every other proposal, so an idea from a screenshot flows straight into the risk gates, your approval, and a bracket order.
1. Drop a chart screenshot into chat (or click "Analyze Chart") 2. KPL reads the levels, the structure, and where price is trading 3. Get a bias + entry / stop / target you can send straight to approval
The KPL methodology is proprietary. Chart reading uses your chosen vision-capable AI model — see AI Providers.
The pipeline
Scan
Data source plugins scan configured symbols for signals at regular intervals (default: every 5 minutes).
Score
The scorer ranks signals by composite score, combining evidence strength, setup quality, and conviction.
AI Decision
Top-ranked setups are sent to your AI provider for analysis. The AI returns approve/reject with reasoning.
Risk Gates
Eight deterministic risk gates evaluate the proposal against your portfolio state and configured limits.
User Approval
Proposals that pass all gates are presented to you in the dashboard. You approve, reject, or modify.
Execution
Approved trades are executed as bracket orders (entry + stop loss + take profit) through IBKR.
Trade proposals
A trade proposal is the core unit of the pipeline. It represents a candidate trade that has been identified, analyzed, and is awaiting your decision.
| Field | Description |
|---|---|
| proposal_id | Unique identifier (e.g. prp-a1b2c3d4e5f6) |
| symbol | Ticker symbol (AAPL, TSLA, etc.) |
| direction | "long" or "short" |
| setup_type | Category: breakout, reversal, pullback_buy, breakdown, etc. |
| conviction | AI confidence score from 0.0 to 1.0 |
| entry_price | Suggested entry price |
| stop_price | Stop loss level |
| target_price | Take profit level |
| thesis_summary | AI-generated explanation of why this trade was proposed |
| composite_score | Overall signal strength from 0.0 to 1.0 |
| status | pending, approved, rejected, executing, executed, or expired |
Approval workflow
When a proposal appears in your dashboard, you have three options:
Approve
Accept the trade as-is. The system creates an approved trade plan and submits bracket orders.
Modify & Approve
Adjust the position size, stop loss, or target price before approving. Modifications are logged in the approvals CSV.
Reject
Decline the trade with an optional reason. The rejection and reason are logged for future analysis.
Proposals expire after the configured timeout (default: 5 minutes). Expired proposals cannot be approved.
Bracket orders
Every approved trade is executed as a bracket order: three linked orders placed simultaneously.
Entry Order Stop Loss Take Profit ──────────── ──────────── ──────────── BUY 50 AAPL SELL 50 AAPL SELL 50 AAPL @ $189.50 @ $185.00 @ $198.00 (market/limit) (stop order) (limit order) All three are submitted together. If entry fills, stop and target become active. If stop or target fills, the other is cancelled.
Post-entry management
After entry, the trade manager monitors the position and applies the management plan:
- •Fixed stops and targets — Default mode. Stop and target stay where they were set.
- •Trailing stops — Stop follows price by a configured offset as the trade moves in your favor.
- •Breakeven stops — Stop moves to entry price after reaching a configurable profit threshold.
- •Scale-out — Partial position exit at intermediate targets (configurable in management plan).
Risk gates
Eight deterministic risk gates evaluate every proposal. All eight must pass for the proposal to reach you.
Stop-Loss Required
Blocks any proposal that has no stop-loss price defined.
Position Size
Blocks if the proposed trade exceeds max_position_pct of account value.
Max Loss Per Trade
Blocks if the loss at your stop would exceed max_single_loss_pct of account value.
Reward vs. Risk
Blocks if the reward-to-risk ratio falls below min_rr_ratio.
Max Open Trades
Blocks if you already have max_positions open trades.
Sector Concentration
Blocks if too many positions are in the same sector.
Portfolio Exposure
Blocks if total exposure would exceed portfolio_max_exposure_pct.
Daily Loss Cap
Halts all trading if daily losses exceed max_daily_loss_pct.