AI multi-analyst research briefing (HEADLINE)
researchFull briefing, bull case, bear case, valuation, investment plan and intrinsic-value range as one structured JSON document. 0.25 credits ($0.25) per successful call, ai_research quota 50/day. Returns the latest completed briefing for the ticker — the same one its public company page shows; a fresh run cannot be started through the API yet (404 when none exists). Not in the sandbox. Keyless trial: with no key and no payment, each IP gets one call every 7 days at no charge (header X-DV-Keyless-Trial says when the next one opens; a 404 or 5xx does not use it). After that, send a live key, or pay this one call with x402 (no key needed); the 402 says the trial was used and when it resets (keyless_trial.resets_at). Same price as /brief, a different product: /brief is a short valuation answer computed at call time; this is the full written briefing. (GET https://app.deepvalues.ai/api/v1/research/{ticker}, e.g. https://app.deepvalues.ai/api/v1/research/AAPL — 0.25 credits per call; one call with no credentials per address every 7 days, at no charge (the keyless research trial); after that it needs a connected account or a dv_sk_ key) Missing data? Call request_data.
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": "research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | The real ticker symbol, e.g. AAPL; share classes as BRK.B or BRK-B. Substitute it into the path (/fundamentals/AAPL), never the literal {ticker}. | |
| language | No | English |