# Live chart

Work on the chart in your open web app. Needs the chart link; a notice shows on screen while it is used, and nothing here places orders.

## chart_status

Says whether your chart is linked and what is on it.

Marks: Reads only · Needs the chart link.

### Inputs

Takes no inputs.

What the AI app reads: Is the web app's chart linked, and what is on it (market, interval, indicators, number of drawings)?

## chart_control

Changes the market or interval on your chart, and adds or removes indicators.

Marks: Makes changes · Needs the chart link.

### Inputs

- `action`: one of `set_symbol`, `set_interval`, `add_indicator`, `remove_indicator`, `remove_all_indicators`, required.
- `symbol`: text (2–40 characters). A market as the exchange names it, like `BTC-PERP`, `HYPE-SPOT` or `xyz:AAPL-PERP`.
- `interval`: text (up to 8 characters).
- `indicator`: text (up to 80 characters).
- `settings`: object of named values, each one of: number; text (up to 40 characters); `true` or `false`.

What the AI app reads: Change the live chart: set_symbol (e.g. ETH-PERP), set_interval (e.g. 15m, 1h, 4h, 1d), add_indicator (by name, with optional settings — explain_indicator lists each one's settings), remove_indicator, remove_all_indicators.

## chart_draw

Draws on your chart with the chart’s own tools: lines, channels, Fibonacci, shapes, patterns, positions and labels.

Marks: Makes changes · Needs the chart link.

### Inputs

- `tool`: text (not empty, up to 60 characters), required.
- `points`: list of 1 to 20; each with these fields, required.
  - `time`: whole number (above 0), required.
  - `price`: number (above 0), required.
- `label`: text (up to 200 characters).
- `color`: text (a colour written `#rrggbb`).

What the AI app reads: Draw on the live chart with one of the chart's own drawing tools. Each point is {time: unix seconds, price}. Tools and how many points each takes: Trend Line (2), Ray (2), Info Line (2), Extended Line (2), Trend Angle (2), Horizontal Line (1), Horizontal Ray (1), Vertical Line (1), Cross Line (1), Parallel Channel (3), Pitchfork (3), Fib Retracement (2), Fib Extension (3), Trend-Based Fib Extension (3), Rectangle (2), Ellipse (2), Triangle (3), Polyline (2+), Arrow (2), XABCD Pattern (5), Cypher Pattern (5), ABCD Pattern (4), Head and Shoulders (7), Triangle Pattern (4), Three Drives Pattern (7), Elliott Impulse Wave (12345) (6), Elliott Correction Wave (ABC) (4), Long Position (2 or 3 with the stop), Short Position (2 or 3 with the stop), Price Range (2), Date Range (2), Date and Price Range (2), Measure (2), Text (1), Note (1), Callout (2), Price Label (1). Long/Short Position: entry then target, optionally a third point for the stop. Optional label (text tools show it) and colour (#rrggbb).

## chart_clear_drawings

Removes every drawing from the chart for the market on screen.

Marks: Makes changes · Needs the chart link · Can’t be undone.

### Inputs

Takes no inputs.

What the AI app reads: Remove every drawing from the live chart for the market on screen. Tell the user first — it cannot be undone from here.

## chart_screenshot

Takes a picture of your chart, so the AI app sees what you see.

Marks: Reads only · Needs the chart link.

### Inputs

Takes no inputs.

What the AI app reads: A picture of the live chart, so you can see what the user sees.

Updated: 2026-10-20

Web page: https://buildtrade.app/docs/tools/chart/