# AI tool reference

The 39 tools an AI app such as Claude can use once you [connect it](https://buildtrade.app/docs/ai-assistant/), in 10 groups. This list is made from the one the connection gives the AI app, so the two always match.

## What the marks mean

- Reads only: Looks at your account or the market and changes nothing.
- Makes changes: Saves, changes or deletes something in your account, never an order.
- Only with May place orders on: Works only if you switched on May place orders when you connected the AI app.
- Two steps: tells you first: The first call does nothing and has the AI app tell you exactly what will happen; the second, after your yes, does it.
- Needs the chart link: Works only while the chart link is on and the Trade screen is open.
- Not on the hosted connection: Answers only on the local helper; on the hosted connection it says so.
- Can’t be undone: What it removes can’t be brought back.

## Help & knowledge

Answers from the help center, the guides, the indicator explanations and the glossary: the same words the app uses.

- [`search_help`](https://buildtrade.app/docs/tools/help/#search_help): Finds the help articles and guides that answer a question, each with its address. (Reads only)
- [`read_help`](https://buildtrade.app/docs/tools/help/#read_help): Reads one whole help article or guide, so an answer can quote it rather than guess. (Reads only)
- [`explain_indicator`](https://buildtrade.app/docs/tools/help/#explain_indicator): Explains a chart indicator the way the app does: what it is in everyday words, then how it is worked out, how traders read it and where it misleads. (Reads only)
- [`glossary_term`](https://buildtrade.app/docs/tools/help/#glossary_term): Looks up a trading word with its plain meaning and why it matters. (Reads only)

## Market data

Prices and where volume traded, for any Hyperliquid market. Read only.

- [`get_candles`](https://buildtrade.app/docs/tools/market-data/#get_candles): Price history for any Hyperliquid market at a chosen interval: open, high, low, close and volume per bar. (Reads only)
- [`get_volume_profile`](https://buildtrade.app/docs/tools/market-data/#get_volume_profile): How much traded at each price over a range: the busiest price and the value area, for the whole range or per day or week. (Reads only)
- [`get_tpo_profile`](https://buildtrade.app/docs/tools/market-data/#get_tpo_profile): The market profile (TPO) of recent sessions: busiest price, value area, first hour’s range, with each price row’s letters. (Reads only)

## Account & trading

What is in your account, and the three tools that trade. Each trading tool works only if you let the AI app place orders, and tells you what it will do before it does it.

- [`list_exchange_connections`](https://buildtrade.app/docs/tools/account-trading/#list_exchange_connections): Lists your exchange connections and whether each is the test network or real. (Reads only)
- [`get_account`](https://buildtrade.app/docs/tools/account-trading/#get_account): Balance, open positions and open orders on one connection. (Reads only)
- [`place_order`](https://buildtrade.app/docs/tools/account-trading/#place_order): Places a market or limit order. Real money on a real connection. (Only with May place orders on · Two steps: tells you first)
- [`cancel_order`](https://buildtrade.app/docs/tools/account-trading/#cancel_order): Cancels one open order. (Only with May place orders on · Two steps: tells you first)
- [`close_position`](https://buildtrade.app/docs/tools/account-trading/#close_position): Closes an open position at market. (Only with May place orders on · Two steps: tells you first)

## Strategies & backtests

Write, change and test strategies on past prices. Nothing here trades.

- [`list_strategies`](https://buildtrade.app/docs/tools/strategies/#list_strategies): Your strategies and the ready-made templates, with the market, timeframe and last test of each. (Reads only)
- [`get_strategy`](https://buildtrade.app/docs/tools/strategies/#get_strategy): One strategy’s full rules: entry, exit, position sizing and risk management. (Reads only)
- [`create_strategy`](https://buildtrade.app/docs/tools/strategies/#create_strategy): Saves a new strategy from rules the AI app writes with you. (Makes changes)
- [`update_strategy`](https://buildtrade.app/docs/tools/strategies/#update_strategy): Changes a saved strategy: its name, rules, market, timeframe or direction. (Makes changes)
- [`run_backtest`](https://buildtrade.app/docs/tools/strategies/#run_backtest): Tests a strategy on past prices between two dates; returns the results and the last few trades. (Saves the test with the strategy)
- [`list_backtests`](https://buildtrade.app/docs/tools/strategies/#list_backtests): A strategy’s past backtests, newest first. (Reads only)
- [`get_backtest`](https://buildtrade.app/docs/tools/strategies/#get_backtest): One saved backtest’s results and its last few trades. (Reads only)

## Edge

What your test results say about risk, worked out from your own trades. Nothing is recommended.

- [`edge_r_summary`](https://buildtrade.app/docs/tools/edge/#edge_r_summary): Explains a backtest in R: average R per trade, win rate, longest losing streak, one of your trades worked through; says so when there are too few trades. (Reads only)
- [`edge_risk_explorer`](https://buildtrade.app/docs/tools/edge/#edge_risk_explorer): Replays your own results thousands of times at different risk per trade: middle and bad cases, the chance of deep falls and of ruin. It recommends nothing. (Reads only)
- [`edge_check_rules`](https://buildtrade.app/docs/tools/edge/#edge_check_rules): Checks a strategy for what is missing or risky before it trades. (Reads only)

## Bots

See your bots, and start, stop, pause or resume one. Each of those works only if you let the AI app place orders, and tells you what it will do first.

- [`list_bots`](https://buildtrade.app/docs/tools/bots/#list_bots): Your bots: status, results so far and totals. (Reads only)
- [`bot_action`](https://buildtrade.app/docs/tools/bots/#bot_action): Starts, stops, pauses or resumes a bot. A running bot trades real money on a real connection. (Only with May place orders on · Two steps: tells you first)

## Alerts

Set, change and delete alerts on price, chart lines and indicators. These don’t need May place orders.

- [`list_alerts`](https://buildtrade.app/docs/tools/alerts/#list_alerts): Your price and rule alerts: on or off, when last fired, why the app switched one off. (Reads only)
- [`list_chart_lines`](https://buildtrade.app/docs/tools/alerts/#list_chart_lines): The lines saved on a market’s chart that an alert can follow. (Reads only)
- [`create_alert`](https://buildtrade.app/docs/tools/alerts/#create_alert): Sets a price alert, or a rule alert of up to five conditions on price, a chart line or an indicator. It reaches you through the bell, email and Discord, as set in Settings › Notifications. (Makes changes)
- [`update_alert`](https://buildtrade.app/docs/tools/alerts/#update_alert): Moves, changes, pauses or turns back on an alert; a changed alert fires again from now. (Makes changes)
- [`delete_alert`](https://buildtrade.app/docs/tools/alerts/#delete_alert): Deletes an alert for good. Pausing it with `update_alert` keeps it. (Makes changes · Can’t be undone)

## Trading books

Passages from the trading-book library. The hosted connection doesn’t include the library: there these tools say so and point to the help tools.

- [`search_trading_books`](https://buildtrade.app/docs/tools/books/#search_trading_books): Searches the trading-book library for passages that back up an answer, naming the book. (Reads only · Not on the hosted connection)
- [`get_book_passage`](https://buildtrade.app/docs/tools/books/#get_book_passage): Reads a whole passage found by the search, with the text around it. (Reads only · Not on the hosted connection)

## Watchlists & screener

Your saved lists and screens, and a screener over every Hyperliquid market.

- [`list_watchlists`](https://buildtrade.app/docs/tools/watchlists/#list_watchlists): Your saved watchlists and screener screens, with live figures for each market if asked. (Reads only)
- [`edit_watchlist`](https://buildtrade.app/docs/tools/watchlists/#edit_watchlist): Makes, changes or deletes a watchlist: add or remove markets, choose its columns and sort. (Makes changes · Two steps to delete a list · A deleted list can’t come back)
- [`run_screen`](https://buildtrade.app/docs/tools/watchlists/#run_screen): Screens every Hyperliquid market by change, volume, open interest, funding, RSI or distance from an average, or runs one of your saved screens. (Reads only)

## 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`](https://buildtrade.app/docs/tools/chart/#chart_status): Says whether your chart is linked and what is on it. (Reads only · Needs the chart link)
- [`chart_control`](https://buildtrade.app/docs/tools/chart/#chart_control): Changes the market or interval on your chart, and adds or removes indicators. (Makes changes · Needs the chart link)
- [`chart_draw`](https://buildtrade.app/docs/tools/chart/#chart_draw): Draws on your chart with the chart’s own tools: lines, channels, Fibonacci, shapes, patterns, positions and labels. (Makes changes · Needs the chart link)
- [`chart_clear_drawings`](https://buildtrade.app/docs/tools/chart/#chart_clear_drawings): Removes every drawing from the chart for the market on screen. (Makes changes · Needs the chart link · Can’t be undone)
- [`chart_screenshot`](https://buildtrade.app/docs/tools/chart/#chart_screenshot): Takes a picture of your chart, so the AI app sees what you see. (Reads only · Needs the chart link)

Updated: 2026-10-20

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