`get_price_candles`

Price candles · read-only, idempotent, no account needed · scopes: read

Price 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_perp_quotes_across_venues) or ready-made indicators (use get_technical_indicators_15m). 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_by_risk.

Call it

MCP tools/call

{"name": "get_price_candles", "arguments": {"symbol": "BTC"}}

REST

GET /v1/markets/{symbol}/candles

Inputs

Name	Meaning (* required)
`symbol` *	Base coin, e.g. BTC
`interval`	Candle length
`limit`	How many candles, newest last (1-500)

Returns

Field	Meaning and unit
`symbol`	Base coin
`interval`	Candle length
`source`	Where the prices come from
`candles`	Oldest first
`high`	Highest high over these candles, USD per coin
`low`	Lowest low over these candles, USD per coin
`change_pct`	From the first open to the last close, as a fraction

Rejections: error codes, each with what to do.