Historical Tradelog

This endpoint returns the trade log for a single trading date. You may filter by market, futures code, or options code. If you omit the date parameter, the API returns the latest available day for the selected filter.

For typical post-close availability, see Data Availability.


Endpoint

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

Parameters

Exactly one of market, futures, or options must be provided in each request. If multiple parameters are specified, the request will be rejected.

NameTypeMandatoryDescription
marketstringYES (mutually exclusive with futures and options)Returns both futures and options data for the selected market.
Accepted market codes:
- au_electricity
- nz_electricity
- au_gas
- au_environmental
- nz_environmental
futuresstringYES (mutually exclusive with market and options)Accepted futures codes:
- Initial code (e.g. BNH, EVJ)
- Exact code (e.g. HNZ2026, GNU2025F)
optionsstringYES (mutually exclusive with market and futures)Accepted options codes:
- Initial code (e.g. HNZ, EEM2025, EAZ2026C)
- Exact code (e.g. BNM2025C0016000)
datestringNODate in format yyyymmdd.
Default: latest date available for the specified code or market.

Errors

StatusWhenBody
400Neither or multiple of market, futures, and options were provided; or the market, code, or date is invalid{"error":"..."}
403Your token is not entitled to the requested market{"error":"forbidden"}
401
429
Authentication failure or rate limit exceededSee Data API overview

For API Trial tokens, a date outside the latest seven trading days returns status 400 with {"error":"invalid date"}.


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

Electricity CSV responses include hours and face_value columns. Gas and environmental markets omit those columns.


Electricity

Returns the trade log for Australian or New Zealand electricity markets (or electricity futures/options codes). Rows include hours and face_value.

Response

NameTypeMandatoryDescription
datestringYESEffective date as yyyymmdd
summaryobjectYESAggregate counts listed below
dataarrayYESTrade data listed below

summary fields:

NameTypeDescription
tradesstringNumber of trades
volumestringSum of trade volumes
traded_mwhstringSum of volume × hours
face_valuestringSum of face values

data array items:

NameTypeNotes
datestringTrade date as yyyymmdd
timestringTrade time as HH:mm:ss (Australia/Sydney)
codestringDisplay code
trade_typeenumTrade type code:
- N: On Screen
- B: Block
- Z: Strip Legs
- E: EFP
volumestringTrade volume
pricestringTrade price
hoursnumberContract hours / MWh factor used for face value
face_valuestringFace value for the trade

Example

Request:

GET https://www.asxenergy.com.au/api/tradelog?market=au_electricity&date=20250219

JSON response:

{
  "date": "20250219",
  "summary": {
    "trades": "387",
    "volume": "1438",
    "traded_mwh": "4669431",
    "face_value": "457633116.96"
  },
  "data": [
    {
      "date": "20250219",
      "time": "10:04:19",
      "code": "HNM2026F",
      "trade_type": "N",
      "volume": "2",
      "price": "121.85",
      "hours": "8760",
      "face_value": "2134812.00"
    }
  ]
}

CSV response:

date,time,code,trade_type,volume,price,hours,face_value
20250219,10:04:19,HNM2026F,N,2,121.85,8760,2134812.00

Gas and environmental

Returns the trade log for gas or environmental markets. Rows do not include hours or face_value. Summary traded_mwh and face_value are always "0" / "0.00".

Response

NameTypeMandatoryDescription
datestringYESEffective date as yyyymmdd
summaryobjectYESAggregate counts listed below
dataarrayYESTrade data listed below

summary fields:

NameTypeDescription
tradesstringNumber of trades
volumestringSum of trade volumes
traded_mwhstringAlways "0" for these markets
face_valuestringAlways "0.00" for these markets

data array items:

NameTypeNotes
datestringTrade date as yyyymmdd
timestringTrade time as HH:mm:ss (Australia/Sydney)
codestringDisplay code
trade_typeenumTrade type code:
- N: On Screen
- B: Block
- Z: Strip Legs
- E: EFP
volumestringTrade volume
pricestringTrade price

Example

Request:

GET https://www.asxenergy.com.au/api/tradelog?market=au_gas

JSON response:

{
  "date": "20250324",
  "summary": {
    "trades": "1",
    "volume": "5",
    "traded_mwh": "0",
    "face_value": "0.00"
  },
  "data": [
    {
      "date": "20250324",
      "time": "13:35:24",
      "code": "GZJ2025F",
      "trade_type": "B",
      "volume": "5",
      "price": "14.50"
    }
  ]
}

CSV response:

date,time,code,trade_type,volume,price
20250324,13:35:24,GZJ2025F,B,5,14.50