Price candles
get_price_candlesPrice history for one coin as candles: open, high, low, close and volume per interval (1m, 5m, 15m, 1h, 4h, 1d), up to 500, oldest first, from Hyperliquid's public market, the same prices the sandbox trades at. Use to look back at price action, find recent highs and lows for a stop, or judge the trend. Not for the live best price (use compare_venue_prices) or ready-made indicators (use get_technical_indicators). Inputs: symbol (base coin), interval (default 1h), limit (default 100). Prices in USD per coin, volume in the base coin, times UTC. Next: size_position.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"symbol": "<symbol>"
},
"name": "get_price_candles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many candles, newest last (1-500) | |
| symbol | Yes | Base coin, e.g. BTC | |
| interval | No | Candle length | 1h |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| low | Yes | Lowest low over these candles, USD per coin | |
| high | Yes | Highest high over these candles, USD per coin | |
| source | Yes | Where the prices come from | |
| symbol | Yes | Base coin | |
| candles | Yes | Oldest first | |
| interval | Yes | Candle length | |
| change_pct | Yes | From the first open to the last close, as a fraction | |
| deprecation | No | Present only while this tool is deprecated: replacement, removal_date, changelog |