analyst_ratings
Fetch per-analyst ratings and consensus for one IDX stock in a single call, including target price and buy/hold/sell counts. An empty result means no coverage, not a failure.
Instructions
What sell-side analysts publish on one IDX stock: the per-analyst rows AND the consensus roll-up (target price, buy/hold/sell counts), fetched together in one call.
Analyst coverage on IDX is thin outside the large caps. An empty ratings or consensus means nobody publishes on that company, which is a real answer about a small-cap and NOT an error — do not retry it and do not report it as a failure.
A request that genuinely failed is different: it appears in failed with its error kind, and the corresponding key is absent rather than empty. If both halves fail the tool errors instead of returning an empty-looking success.
PENDING: neither response shape has been observed live, so both payloads are returned unprojected — read the target price and the rating counts out of them rather than expecting named fields.
This reports what analysts said, not whether they were right, and nothing here is a recommendation.
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": {
"symbol": "<symbol>"
},
"name": "analyst_ratings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | IDX ticker, e.g. BBRI |