Get stock research
get_stock_researchTalval's valuation verdict, fair-value estimate, upside, quality/safety/value scores and latest filed results for one ticker. End-of-day snapshot with a date.
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_stock_research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | Exact ticker as Talval lists it, e.g. 'AAPL', 'RHM.DE', 'PRU.L'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| name | No | ||
| as_of | No | Date of the verdict snapshot, YYYY-MM-DD. | |
| price | No | ||
| scores | No | 0-100, null where the inputs behind a score are missing. | |
| sector | No | ||
| ticker | Yes | ||
| country | No | ||
| covered | Yes | False when Talval does not cover this ticker; every other field is then null. | |
| verdict | No | Undervalued, Fairly valued or Overvalued. | |
| currency | No | Trading currency of price and fair value. | |
| industry | No | ||
| conviction | No | 1-10. | |
| fair_value | No | Null when withheld — see fair_value_usable and withheld_reason. | |
| market_cap | No | ||
| risk_level | No | ||
| upside_pct | No | Percent, not a fraction. | |
| pe_trailing | No | ||
| price_as_of | No | ||
| latest_annual | No | As reported in the company's own filings — not estimates. | |
| withheld_reason | No | Why fair_value is null, when it is. | |
| fair_value_usable | No | False when the company reports in a different currency than it trades in, which makes every price-to-fundamentals figure cross-currency nonsense. A false here is a deliberate suppression, not missing data. | |
| dividend_yield_pct | No | Forward yield as a PERCENT, e.g. 2.9 for 2.9%. |