Price Candles (OHLCV)
Returns OHLCV candlestick data from TimescaleDB metric history.
Each candle is an array: [timestamp_ms, open, high, low, close, volume24h].
volume24h is the rolling 24-hour volume at candle close, not per-interval volume.
Interval defaults and caps:
| Interval | Default range | Max range |
|---|---|---|
5m | 24 hours | 48 hours |
1h | 7 days | 14 days |
1d | 30 days | 90 days |
If the requested range exceeds the max, start is clamped forward (most recent candles are returned).
Path Parameters
id*string
MongoDB ObjectId of the project
Query Parameters
interval*string
Candle interval
Value in
"5m" | "1h" | "1d"start?string
Start timestamp (ISO 8601). Defaults to interval-dependent lookback from end.
Format
date-timeend?string
End timestamp (ISO 8601). Defaults to now.
Format
date-timeat?string
Historical anchor timestamp (ISO 8601). Caps end and shifts the default lookback.
Must be in the past.
When used:
- If
endis not provided,atsets the end of the window - If
endis provided,atacts as a ceiling —endis capped to whichever is earlier - If
startis not provided, it defaults to the interval's default lookback beforeat
Format
date-timeResponse Body
application/json
curl -X GET "https://example.com/v2/projects/string/candles?interval=5m&at=2026-03-25T12%3A00%3A00Z"{
"status": 200,
"meta": {
"upgrade": {
"description": "string",
"protocol": "x402",
"payment": "USDC on Base",
"options": [
{
"period": "1 day",
"price": "$10",
"method": "POST",
"url": "https://api.aixbt.tech/x402/v2/api-keys/1d"
}
]
}
},
"error": "",
"data": {
"projectId": "507f1f77bcf86cd799439011",
"projectName": "Bitcoin",
"interval": "1h",
"candles": [
[
1709395200000,
0.0523,
0.0531,
0.0519,
0.0527,
1234567
]
]
}
}Empty
Empty
Empty
Empty
Empty