Get OHLCV (Open, High, Low, Close, Volume) price data for a token with automatic interval resolution.
Supports EVM chains and Solana for on-chain tokens, AND Hyperliquid perpetual futures.
For Hyperliquid perps, pass `chain="hyperliquid"` and use the perp symbol as `tokenAddress` (e.g. "BTC", "HYPE" for native perps; "XYZ:ORDI" for XYZ-namespaced perps — prefix is normalized automatically).
**YOU MUST USE THIS** over `general_search` to get prices. **`general_search` prices are delayed and often incorrect.**
To get **LATEST** price set from to '5MIN_AGO' and to to 'NOW'.
Resolution is automatically calculated based on the date range
- < 6 hours: 5 minutes
- 6 hours - 1 day: 15 minutes
- 1-3 days: 30 minutes
- 3-7 days: 60 minutes (1 hour)
- 7-90 days: Daily
- 90+ days: Weekly
Columns returned:
- **Interval Start**: Timestamp of the start of the interval (datetime: YYYY-MM-DD HH:MM:SS)
- **Open**: Opening price of the interval
- **High**: Highest price of the interval
- **Low**: Lowest price of the interval
- **Close**: Closing price of the interval
- **Volume USD**: Volume in USD of the interval
Additional columns (when includeMarketCap=true):
- **Open Market Cap**: Opening market cap in USD
- **Close Market Cap**: Closing market cap in USD
- **High Market Cap**: Highest market cap in USD
- **Low Market Cap**: Lowest market cap in USD
Example Usage:
Get OHLCV for WETH over the past week (auto-resolution):
```
{
"chain": "ethereum",
"tokenAddress": "0xba5ddd1f9d7f570dc94a51479a000e3bce967196",
"date": {
"from": "7D_AGO",
"to": "NOW"
}
}
```
Get OHLCV for WETH over 30 days (will use daily resolution):
```
{
"chain": "ethereum",
"tokenAddress": "0xba5ddd1f9d7f570dc94a51479a000e3bce967196",
"date": {
"from": "30D_AGO",
"to": "NOW"
}
}
```
Get OHLCV for WETH for last 20 minutes (will use 5 minute resolution):
```
{
"chain": "ethereum",
"tokenAddress": "0xba5ddd1f9d7f570dc94a51479a000e3bce967196",
"date": {
"from": "20MIN_AGO",
"to": "NOW"
}
}
```
Get OHLCV for the BTC Hyperliquid perp over 7 days:
```
{
"chain": "hyperliquid",
"tokenAddress": "BTC",
"date": {
"from": "7D_AGO",
"to": "NOW"
}
}
```