| 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
chart_set_symbol — switch to the requested symbol
chart_set_timeframe — set the appropriate timeframe
- 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
capture_screenshot — screenshot the annotated chart
data_get_ohlcv — pull recent price data for quantitative analysis
quote_get — get the current real-time price
symbol_info — get symbol metadata (exchange, type, session)
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
draw_clear to remove all drawings if they were temporary