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.
GET https://www.asxenergy.com.au/api/tradelog
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. |
| 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"} |
401429 | 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"}.
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.
Returns the trade log for Australian or New Zealand electricity markets (or electricity futures/options codes). Rows include hours and face_value.
| 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 |
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
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".
| 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 |
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