chart-analysis

# Chart Analysis Workflow You are performing technical analysis on a TradingView chart. > **Power-toolkit shortcut:** if you only need a snapshot read (state + quote + indicators + Pine graphics + OHLCV), call `chart_vision_read` once instead of stepping through `chart_get_state` → `data_get_study_values` → `data_get_pine_*` → `data_get_ohlcv`. ## Step 1: Set Up the Chart 1. `chart_set_symbol` — switch to the requested symbol 2. `chart_set_timeframe` — set the appropriate timeframe 3. Wait for the chart to load (the tool handles this) ## Step 2: Add Indicators Use `chart_manage_indicator` to add studies. Common names (must use FULL names): - "Relative Strength Index" (not RSI) - "Moving Average Exponential" (not EMA) - "Moving Average" (for SMA) - "MACD" - "Bollinger Bands" - "Volume" - "VWAP" - "Average True Range" After adding, use `indicator_set_inputs` to customize settings (e.g., change EMA length to 200). ## Step 3: Navigate to Key Areas - `chart_scroll_to_date` — jump to a specific date of interest - `chart_set_visible_range` — zoom to a specific date window - `chart_get_visible_range` — check what's currently visible ## Step 4: Annotate Use drawing tools to mark up the chart: - `draw_shape` with `horizontal_line` for support/resistance - `draw_shape` with `trend_line` for trend channels (needs two points) - `draw_shape` with `text` for annotations ## Step 5: Capture and Analyze 1. `capture_screenshot` — screenshot the annotated chart 2. `data_get_ohlcv` — pull recent price data for quantitative analysis 3. `quote_get` — the price the **chart** currently holds, which is not the same thing as the live price. It reads the chart's own series, so it is only as fresh as the chart's data connection, and it returns `success: true` with a stale bar and no warning when that connection has dropped. Compare its `time` against the current bar, or read `tv_health_check` first and treat a `datafeed.state` of `disconnected` as "every price on this chart is stale". For a price that does not depend on the chart's connection, use `quote_batch`, which goes to TradingView's scanner API instead. 4. `symbol_info` — symbol metadata (exchange, type, session). It fails on a chart whose data session has dropped, because the metadata never resolved, and the error it returns says the TradingView API "returned an unexpected shape" and invites you to file an issue. **Do not file anything, and do not report the connector to the user as broken.** Verified on a live chart: the series and its 307 bars were both present while the symbol metadata was still null, and `chart_get_state` was answering normally throughout. Read `tv_health_check` and report the data connection, which is the actual finding. ## Step 6: Report Provide the analysis: - Current price and recent range - Key support/resistance levels identified - Indicator readings (RSI overbought/oversold, MACD crossover, etc.) - Overall bias (bullish/bearish/neutral) with reasoning ## Cleanup If you added indicators the user didn't ask for, remove them: - `chart_manage_indicator` with action "remove" and the `entity_id` from `chart_get_state` - `draw_clear` to remove all drawings if they were temporary `chart_get_state` reports `id: null` with `addressable_by: "name"` for a study that never finished registering with the server. That study is damage, not a quirk: it kills the pane's data session on every reconnect. Do not try to work around the missing id — run `tv_chart_health`, then `tv_repair_chart`, and add the study back with `indicator_add_from_search`. `chart_get_state` also carries a `chart_health` block when the pane it is describing is broken; read it before reporting the chart as fine.