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.

Name Type Mandatory Description
market string YES (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
futures string YES (mutually exclusive with market and options) Accepted futures codes:
- Initial code (e.g. BNH, EVJ)
- Exact code (e.g. HNZ2026, GNU2025F)
options string YES (mutually exclusive with market and futures) Accepted options codes:
- Initial code (e.g. HNZ, EEM2025, EAZ2026C)
- Exact code (e.g. BNM2025C0016000)
date string NO Date in format yyyymmdd.
Default: latest date available for the specified code or market.

Errors

Status When Body
400 Neither or multiple of market, futures, and options were provided; or the market, code, or date 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

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

Name Type Mandatory Description
date string YES Effective date as yyyymmdd
summary object YES Aggregate counts listed below
data array YES Trade data listed below

summary fields:

Name Type Description
trades string Number of trades
volume string Sum of trade volumes
traded_mwh string Sum of volume × hours
face_value string Sum of face values

data array items:

Name Type Notes
date string Trade date as yyyymmdd
time string Trade time as HH:mm:ss (Australia/Sydney)
code string Display code
trade_type enum Trade type code:
- N: On Screen
- B: Block
- Z: Strip Legs
- E: EFP
volume string Trade volume
price string Trade price
hours number Contract hours / MWh factor used for face value
face_value string Face 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

Name Type Mandatory Description
date string YES Effective date as yyyymmdd
summary object YES Aggregate counts listed below
data array YES Trade data listed below

summary fields:

Name Type Description
trades string Number of trades
volume string Sum of trade volumes
traded_mwh string Always "0" for these markets
face_value string Always "0.00" for these markets

data array items:

Name Type Notes
date string Trade date as yyyymmdd
time string Trade time as HH:mm:ss (Australia/Sydney)
code string Display code
trade_type enum Trade type code:
- N: On Screen
- B: Block
- Z: Strip Legs
- E: EFP
volume string Trade volume
price string Trade 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