OHLCV candles API for crypto, stocks, gold and oil
Where can an AI agent get OHLCV candles for BTC, NVDA or gold?
Call GET /v1/markets/candles with a symbol, an interval (15m, 1h, 4h, 1d or 1w) and a limit up to 500. You get open, high, low, close, volume and trade count per candle, newest last, with the newest marked while it is still forming.
Example: hourly ETH candles
Example call: markets-candles
Parameters
| Param | Values | Default |
|---|---|---|
| symbol | Crypto: BTC, ETH, SOL, XRP, HYPE, BNB, DOGE. US stocks: NVDA, AAPL, MSFT, GOOGL, AMZN, META, TSLA, AMD, MU, COIN, MSTR, HOOD, PLTR. Indexes: SP500, XYZ100. Commodities: GOLD, SILVER, CL (WTI crude), BRENTOIL (Brent crude). | required |
| interval | 15m, 1h, 4h, 1d, 1w | 4h |
| limit | 1 to 500 candles, newest last | 100 |
Details
Each candle has time (open), close_time, open, high, low, close, volume, trades and forming. If you only need an indicator, the indicator endpoint computes it for you and saves the agent the maths.
Prices come from Hyperliquid perpetuals: crypto from the main Hyperliquid market, stocks, indexes and commodities from trade.xyz markets on Hyperliquid. They trade 24/7 and track the asset, but they are not exchange quotes, so a stock value can differ from the last Nasdaq or NYSE print, most of all outside US market hours.
FAQ
How much history can I get?
Up to 500 candles per call at any interval, for example about 20 days of hourly candles. Older history is limited to what the venue holds for that market.
Is volume in coins or dollars?
Candle volume is in units of the asset on the venue. For 24 h volume in USD, use the snapshot or scan endpoints.
Updated 2026-11-16.