Research Reports

AI-generated investment research. Generate deep-dive reports or retrieve existing ones.

POST/api/stocks/research

Generate an AI-powered research report for a stock.

Request Body

Field	Type	Required	Description
ticker	string	Yes	Stock ticker (e.g. AAPL, 9988.HK)
reportType	string	No	Report type: sun-tzu (default), thematic, comparative

Response

{
  "jobId": "res_abc123",
  "status": "processing",
  "message": "Report generation started. Poll /api/stocks/research-status for updates."
}

GET/api/stocks/research-status

Check the status of a research report generation job.

Parameters

Name	Type	Required	Description
jobId	string	Yes	Job ID returned from POST /api/stocks/research

Response

{
  "jobId": "res_abc123",
  "status": "completed",
  "reportId": "AAPL",
  "url": "https://claudiusinc.com/markets/research/AAPL"
}

GET/api/stocks/reports

List all saved research reports.

Parameters

Name	Type	Required	Description
type	string	No	Filter by type: sun-tzu, thematic, comparative

Response

{
  "reports": [
    {
      "ticker": "AAPL",
      "title": "Apple (AAPL): Sun Tzu Deep Dive",
      "reportType": "sun-tzu",
      "slug": "AAPL",
      "url": "https://claudiusinc.com/markets/research/AAPL",
      "createdAt": "2026-04-28T00:00:00Z"
    }
  ]
}

GET/api/markets/research

Alternative endpoint for research reports (same data).

Response

{
  "reports": [ ... ]
}