latest
Retrieve the most recent interval from NEM datasets, covering 5-minute dispatch prices, 30-minute rooftop PV, or daily summaries. Filter 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 the search endpoint or search tool 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 | ||
| period | No | Canonical {start, end} period bounds for cross-sister consumers. Populated alongside aemo-specific interval_start/interval_end. | |
| unit | No | ||
| row_count | No | Number of observation rows in records. | |
| 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 | ||
| stale_reason | No | ||
| truncated_at | No | ||
| server_version | No |