latest
Retrieve the most recent interval data for NEM datasets such as dispatch prices or generation mix. Apply optional filters to narrow results by region or fuel type.
Instructions
Return the most recent interval(s) for a NEM dataset.
For 5-min feeds (dispatch_price, dispatch_region, interconnector_flows, generation_scada): returns the most recent 5-minute interval, typically 1-2 minutes after the interval close.
For 30-min feeds (rooftop_pv, predispatch_30min): the most recent half-hour.
For daily feeds (daily_summary): yesterday's data.
Examples: # Current NSW spot price resp = await latest("dispatch_price", filters={"region": "NSW1"})
# Current generation mix in QLD
resp = await latest("generation_scada", filters={"region": "QLD1"})
# Current flow across Heywood
resp = await latest("interconnector_flows", filters={"interconnector": "V-SA"})Returns:
DataResponse with one observation per filtered (dimension, metric)
tuple at the most recent interval. stale=True flag indicates the
most recent interval is older than 2× the feed cadence (NEMWEB
delay).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | Dataset ID like 'dispatch_price'. Use search_datasets() to discover. | |
| filters | No | Optional filter dict. Same shape as get_data — narrow to a region, interconnector, fuel, etc. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | ||
| dataset_name | Yes | ||
| query | No | ||
| interval_start | No | ||
| interval_end | No | ||
| unit | No | ||
| records | No | ||
| csv | No | ||
| source | No | Australian Energy Market Operator | |
| attribution | No | Source: Australian Energy Market Operator (AEMO), NEMWEB. Used under AEMO's Copyright Permissions (general permission for any purpose with accurate attribution). https://aemo.com.au/privacy-and-legal-notices/copyright-permissions | |
| source_url | Yes | ||
| retrieved_at | Yes | ||
| stale | No | ||
| server_version | No |