Chart Analysis

---
name: chart-analysis
description: Analyze a chart — set up symbol/timeframe, add indicators, scroll to key dates, annotate, and screenshot. Use when the user wants technical analysis or chart review.
---

# 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.