get_earnings
Get earnings results for an NZX company. Extracted from full-year and half-year announcements. Includes revenue, net profit, EBITDA, EPS, DPS, and management guidance.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "get_earnings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year or range | |
| limit | No | Max results | |
| period | No | Period: annual, interim, or all | |
| ticker | Yes | NZX ticker symbol |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or "none found". | |
| meta | Yes | ||
| tool | Yes | Tool that produced this result. | |
| schema_version | Yes | Envelope contract version. Bumps only on a breaking shape change. |