Reference
Timeframes
Window lengths, UTC alignment and how market ids are formed.
Supported timeframes
| Timeframe | Label | Duration | Windows / day | Window containing 20:07:31 UTC |
|---|---|---|---|---|
| 5m | 5 Min | 300 s | 288 | 20:05 → 20:10 UTC |
| 15m | 15 Min | 900 s | 96 | 20:00 → 20:15 UTC |
| 1h | 1 Hour | 3,600 s | 24 | 20:00 → 21:00 UTC |
| 4h | 4 Hours | 14,400 s | 6 | Nov 14 20:00 → Nov 15 00:00 UTC |
| 1d | 1 Day | 86,400 s | 1 | Nov 14 00:00 → Nov 15 00:00 UTC |
Window alignment
Windows are aligned to the Unix epoch in UTC: window i of a timeframe with duration d spans [i·d, (i+1)·d). In practice 15-minute windows open at :00, :15, :30 and :45; 4-hour windows open at 00:00, 04:00, 08:00, 12:00, 16:00 and 20:00 UTC; daily windows open at 00:00 UTC. There are no daylight-saving shifts, and windows never overlap.
The end of one window is the start of the next: its Settlement Price is computed at the same instant as the next window's Price To Beat.
Market ids
Market ids are deterministic ({asset}-{timeframe}-{YYYYMMDD}-{HHMM}, using the UTC window start), so you can compute the id of any window without a lookup:
| Market | Market id |
|---|---|
| BTC · 5 Min | btc-5m-20261114-2005 |
| ETH · 15 Min | eth-15m-20261114-2000 |
| SOL · 1 Hour | sol-1h-20261114-2000 |
| GOLD · 4 Hours | gold-4h-20261114-2000 |
| OIL · 1 Day | oil-1d-20261114-0000 |
Timeframes
/Supported window lengths and alignment rules.
Parameters
This endpoint takes no parameters.
Request
# export PROBORA_API_KEY=prb_live_…
curl "https://api.probora.xyz/v1/timeframes" \
-H "Authorization: Bearer $PROBORA_API_KEY"Response
200 OK, returned as application/json. Example:
{
"data": [
{
"slug": "5m",
"label": "5 Min",
"seconds": 300,
"alignment": "UTC epoch"
},
{
"slug": "1d",
"label": "1 Day",
"seconds": 86400,
"alignment": "00:00 UTC"
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
| data | array | Page of results, newest first. |
Fields of each item in data
| Field | Type | Description |
|---|---|---|
| slug | string | Identifier. |
| label | string | Display label. |
| seconds | integer | Window length in seconds. |
| alignment | string | How window boundaries are aligned. |
Questions or feedback on the API? [email protected]