peer_comparison
Compares a stock's valuation ratios with its industry aggregate side by side to help judge whether a ratio is cheap or expensive relative to peers.
Instructions
A stock's valuation ratios AND its INDUSTRY aggregate, side by side. This is the denominator that absolute valuation bands do not have: 'PBV 1.2' is expensive for a bank and cheap for a consumer name, and the analyze tool's valuation pillar scores against fixed bands and says in its own output that this is systematically wrong for banks, property and cyclicals. Use this tool before calling any ratio cheap or expensive.
Which number is which is never ambiguous: in paired, symbolValue is the company you asked about and industryValue is Stockbit's aggregate for its industry. symbolOnly and industryOnly are metrics that exist on one side only, so there is nothing to compare them with. otherCompanies holds rows the payload attributed to a DIFFERENT ticker — the peer set, not the subject — and they are deliberately excluded from the pairing.
NO VERDICT IS COMPUTED. These are Stockbit's numbers placed next to each other; the judgement is yours, and 'below the industry' is not by itself a reason to buy anything.
PENDING: the comparison response shapes are unverified, so the pairing is a best-effort match on label TEXT rather than a mapped schema. Every reading records the wire key it came from (labelKey/valueKey) and its path inside raw, so check a pair before relying on it. A label that matched more than one reading on a side is listed under ambiguous with all its candidates instead of being paired arbitrarily. If paired is empty, that is a shape problem and the raw payloads are attached — it is not a statement about the company.
include_catalogues adds the comparison metric vocabulary and the account's saved comparison sets. It costs two extra requests and answers 'what can be compared', not 'how does this company compare', so leave it off unless that is the question.
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": "peer_comparison"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | IDX ticker, e.g. BBRI | |
| include_raw | No | Keep the unprojected payloads under `raw` (default true; set false if too large) | |
| include_catalogues | No | Also fetch the comparison metric list and saved comparison sets (default false) |