latest
Get the most recent data point per measure from a dataset, answering current-value questions like 'What is CBA's CET1 ratio?'.
Instructions
Return the most recent observation per measure for a dataset.
Trims to the single latest period per measure across the filtered slice
— useful for "what's CBA's current CET1?" style questions without having
to think about start_period. Wide-layout entity-level datasets
(INSURANCE_GENERAL etc.) are capped at limit rows.
Examples: # Latest CBA capital ratios resp = await latest("ADI_KEY_STATS", filters={"institution": "cba"})
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return. Wide-layout entity-level datasets (INSURANCE_GENERAL ~2,000 rows per quarter) can blow an agent's context window without a cap. Pass filters to narrow to one entity; raise `limit` only if you genuinely need a bulk dump. Truncated responses set DataResponse.truncated_at to the original row count. | |
| filters | No | Same filter shape as get_data. Useful for narrowing to one entity. | |
| measures | No | Same as get_data. | |
| dataset_id | Yes | Curated dataset ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv | No | ||
| unit | No | ||
| query | No | ||
| stale | No | ||
| period | No | ||
| source | No | Australian Prudential Regulation Authority | |
| records | No | ||
| apra_url | Yes | Click-through URL for this dataset's source page. apra-mcp legacy name — prefer source_url (canonical) for new code. Both fields are populated identically. | |
| framework | No | ||
| row_count | No | ||
| dataset_id | Yes | ||
| source_url | Yes | Canonical click-through URL. Same value as apra_url; both populated for backward compat. | |
| attribution | No | Source: Australian Prudential Regulation Authority. Licensed under Creative Commons Attribution 3.0 Australia (https://creativecommons.org/licenses/by/3.0/au/). | |
| dataset_name | Yes | ||
| download_url | No | ||
| retrieved_at | Yes | ||
| stale_reason | No | ||
| truncated_at | No | ||
| server_version | No |