API Reference

{
  "symbols": ["AAPL", "MSFT"],  // 1-10 symbols
  "n": 5,                        // 1-20 news items (default: 5)
  "language": "en",              // ISO 639-1 code
  "data": {}                     // Optional custom data
}

{
  "job_id": "uuid",
  "status": "completed",
  "from_cache": true,
  "news": [
    {
      "title": "string",
      "content": "string",
      "sources": ["url"],
      "further_reading": ["url"],
      "relevance_score": 0.95
    }
  ]
}

{
  "symbols": ["AAPL"],           // 1 for analysis, 2 for comparison
  "language": "en",              // ISO 639-1 code
  "data": {}                     // Optional financial data
}

{
  "job_id": "uuid",
  "status": "completed",
  "from_cache": false,
  "detailed_analysis": [
    {
      "title": "string",
      "keyMetric": "string",
      "implications": ["string"],
      "investmentThesis": "string",
      "category": "growth|profitability|risk|valuation|competitive"
    }
  ],
  "quick_insights": ["string"]
}

{
  "prompt": "string",                    // Required: Your analysis question
  "symbols": ["AAPL", "MSFT"],          // Optional: Stock symbols
  "portfolio_composition": [             // Optional: Portfolio weights
    {"symbol": "SPY", "percentage": 60}
  ],
  "data": {},                           // Optional: Custom data
  "output_format": {                    // Optional: Response format
    "type": "json_schema|json|markdown",
    "schema": {},                       // For json_schema type
    "stream": true                      // Enable streaming
  }
}

{
  "job_id": "uuid",
  "status": "pending|completed",
  "result": {},                         // When completed
  "status_url": "/api/jobs/analysis/{job_id}/status",
  "result_url": "/api/jobs/analysis/{job_id}/result"
}

// Server-Sent Events stream
event: synthesis_chunk
data: {"chunk": "text content..."}

event: done
data: {"job_id": "uuid", "status": "completed"}

{
  "message": "string",              // User's message
  "conversation_id": "uuid|null",   // null for new conversation
  "stream": true                    // Enable streaming (default: true)
}

event: token
data: {"type": "token", "content": "text..."}

event: node_start
data: {"type": "node_start", "node": "research"}

event: tool_start
data: {"type": "tool_start", "tool": "market_data"}

event: done
data: {"type": "done", "conversation_id": "uuid"}