Available Dates

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.


Endpoint

GET https://www.asxenergy.com.au/api/dates

Parameters

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_environmental
Accepted 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_electricity
Accepted options codes:
- Initial code (e.g. BNZ, HQZ2026)
- Exact code (e.g. HNZ20260012000, EAH20260010000C)

Errors

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"}
401
429
Authentication failure or rate limit exceeded See Data API overview

CSV Support

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

Response

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.

Example

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