Understanding the trading flow
BrokerBridge follows a six-stage pipeline. Each stage is deterministic and auditable. Nothing executes without your explicit approval.
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
Five 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
Five deterministic risk gates evaluate every proposal. All five must pass for the proposal to reach you.
Position Size
Blocks if the proposed trade exceeds max_position_pct of account value.
Max Open Trades
Blocks if you already have max_positions open trades.
Daily P&L Cap
Halts all trading if daily losses exceed max_daily_loss_pct.
Sector Concentration
Blocks if too many positions are in the same sector.
Portfolio Exposure
Blocks if total exposure would exceed portfolio_max_exposure_pct.