multi-pane-analysis

# Multi-Pane Cross-Asset Analysis You are using TradingView's pane layouts to reason across several correlated instruments at once. > **Power-toolkit shortcuts:** snapshot the current layout with `state_snapshot` before mutating it (so the user can `state_restore` afterwards). Use `chart_vision_read` per active pane to grab everything (image + indicators + Pine graphics) in one call. ## Step 1: Choose the Layout 1. `pane_set_layout` — typical choices: - `"2x2"` for four symbols (e.g., the index complex) - `"1x2"` / `"2x1"` for two - `"1x3"` / `"3x1"` for three Example — index complex: `pane_set_layout({ layout: "2x2" })`. ## Step 2: Assign Symbols Use `pane_set_symbol` once per pane. The pane argument is `index` (0-based), not `pane`. Common correlated baskets: - **US Index complex**: `ES1!` (SP500), `NQ1!` (Nasdaq), `YM1!` (Dow), `RTY1!` (Russell) - **Energy**: `CL1!` (WTI), `BZ1!` (Brent), `NG1!` (Nat Gas), `XLE` - **Metals**: `GC1!` (Gold), `SI1!` (Silver), `HG1!` (Copper), `PL1!` (Platinum) - **Crypto majors**: `BTCUSD`, `ETHUSD`, `SOLUSD`, `TOTAL` - **Risk-on/off**: `SPY`, `TLT`, `DXY`, `VIX` ``` pane_set_symbol({ index: 0, symbol: "ES1!" }) pane_set_symbol({ index: 1, symbol: "NQ1!" }) pane_set_symbol({ index: 2, symbol: "YM1!" }) pane_set_symbol({ index: 3, symbol: "RTY1!" }) ``` If a pane errors with `CHART_LOADING`, wait ~2s before querying that pane. ## Step 3: Align Timeframes `pane_set_symbol` takes only `index` and `symbol`, so it cannot set a timeframe. Loop through the panes calling `chart_set_timeframe` after `pane_focus`. All panes should match (e.g., all 15m) for valid comparison. ## Step 4: Stream or Poll Poll: `pane_list` to enumerate panes, then `quote_batch` with every pane's symbol in one call, plus per-pane `data_get_ohlcv` with `summary: true`. Use `quote_batch` here, not a `quote_get` per pane. `quote_get` for a symbol that is not the active chart symbol **briefly switches the chart and switches it back**, so polling it per pane visibly thrashes the user's layout on a timer. `quote_batch` reads the scanner API, touches nothing, and is unaffected by a dropped chart data connection. There is no push/stream tool on this connector, so re-poll on a timer for live monitoring rather than waiting for updates that will never arrive. ## Step 5: Compute Relative Moves For each pane, pull: - `quote_batch` — current price + change% for every pane symbol at once (see Step 4 for why this is not a per-pane `quote_get`) - `data_get_ohlcv` with `summary: true, count: 20` — recent range Compute normalized % moves since session open (or since any anchor bar). The **leader** is the one with the largest % change in the dominant direction; the **laggard** is the smallest; **divergence** is when one pane goes opposite the rest. Example output: ``` ES1! +0.42% (laggard) NQ1! +0.91% (LEADER — tech leading risk-on) YM1! +0.18% RTY1! -0.35% (DIVERGENCE — small caps down while indices up) ``` ## Step 6: Annotate Divergences If you spot a divergence: 1. `pane_focus` on the divergent pane 2. `draw_shape` with `text` marking the divergence bar 3. `capture_screenshot` with `region: "full"` so all four panes are in frame ## Step 7: Report Provide the cross-asset read: - **Leader / laggard / divergent** with % moves - **Correlation check** — are the normally-correlated pairs still in sync? (e.g., ES/NQ typically correlated; if they split, note it) - **Actionable interpretation** — e.g., "RTY1! weakness while ES1!/NQ1! rally = narrow breadth, fade long setups on indices" ## Cleanup If the user wanted a single-pane view back: - `pane_set_layout` with `"1x1"` - Or `state_restore` if a prior snapshot exists