This endpoint returns every trading date (yyyymmdd) for which end-of-day data exists for the requested futures or options filter. Use it to discover historical coverage before calling End-of-Day Data or related endpoints.
Further notes on history depth and trial limits are in Data Availability.
GET https://www.asxenergy.com.au/api/dates
Exactly one of futures or options must be provided in each request. If multiple parameters are specified, the request will be rejected.
| Name | Type | Mandatory | Description |
|---|---|---|---|
| futures | string |
YES (mutually exclusive with options) | Get all available dates for futures products. Accepted market codes: - au_electricity- nz_electricity- au_gas- au_environmental- nz_environmentalAccepted futures codes: - Initial code (e.g. BNH, EVJ) - Exact code (e.g. HNZ2026, GNU2025) |
| options | string |
YES (mutually exclusive with futures) | Get all available dates for options products. Accepted market codes: - au_electricity- nz_electricityAccepted options codes: - Initial code (e.g. BNZ, HQZ2026) - Exact code (e.g. HNZ20260012000, EAH20260010000C) |
| Status | When | Body |
|---|---|---|
400 |
Neither or both of futures and options were provided, or the code is invalid |
{"error":"..."} |
403 |
Your token is not entitled to the requested market | {"error":"forbidden"} |
401429 |
Authentication failure or rate limit exceeded | See Data API overview |
The API supports CSV-formatted responses when requested via the Accept header. To receive data in CSV format, set the following header in your request:
Accept: text/csv
| Name | Type | Mandatory | Description |
|---|---|---|---|
| dates | array |
YES | Ascending list of available dates in yyyymmdd format |
API Trial tokens receive only the latest seven dates in the list.
Request:
GET https://www.asxenergy.com.au/api/dates?futures=au_electricity
JSON response:
{
"dates": [
"20090619",
"20090622",
"20090623",
"20250212",
"20250213",
"20250214",
"20250217"
]
}
CSV response:
date
20130508
20130509
20130510