GET /v1/ohlc Premium (2×)
OHLCV Historical Data
Retrieve historical candlestick data (Open, High, Low, Close, Volume) for charting, backtesting, and analysis. Up to 500 bars per request across 7 timeframes.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Trading symbol (e.g., EURUSD, XAUUSD) |
| timeframe | string | Yes | M1, M5, M15, M30, H1, H4, D1 |
| bars | integer | No | Number of bars (1–500, default: 100) |
| from | string | No | Start time (ISO 8601). Must be within retention window. |
| to | string | No | End time (ISO 8601). Defaults to now. |
Example Request
cURL
curl -H "X-API-Key: YOUR_API_KEY" \
"https://tickatlas.com/v1/ohlc?symbol=EURUSD&timeframe=H1&bars=100" Success Response
200 OK
{
"success": true,
"symbol": "EURUSD",
"timeframe": "H1",
"bars": [
{
"time": "2026-03-21T13:00:00Z",
"open": 1.08432,
"high": 1.08456,
"low": 1.08421,
"close": 1.08443,
"volume": 12450
},
{
"time": "2026-03-21T12:00:00Z",
"open": 1.08410,
"high": 1.08438,
"low": 1.08395,
"close": 1.08432,
"volume": 10890
}
],
"total_bars": 100,
"metadata": {
"source": "live",
"data_age_seconds": 2
}
} Data Retention by Timeframe
Historical data availability varies by timeframe. Requests outside the retention window return an error with the earliest available timestamp.
| Timeframe | Data Retained |
|---|---|
| D1 | 45 days |
| H4 | 30 days |
| H1 | 15 days |
| M30 | 7 days |
| M15 | 3 days |
| M5 | 2 days |
| M1 | 24 hours |