analyze_stock
Get a unified bull/bear signal for any stock by aggregating AI prediction, implied volatility, options pressure, Monte Carlo simulation, and backtesting.
Instructions
Run a full institutional-grade quantitative analysis for a single stock.
This is the primary tool for a complete market view. It aggregates results from AI prediction, implied-volatility radar, options-pressure map, Monte Carlo simulation, and strategy backtesting into one unified signal.
Use this tool when:
You need a holistic bull/bear verdict with supporting evidence.
You want to compare multiple signal sources in a single call.
A user asks for a "stock analysis", "market view", or "trading signal".
Prefer the dedicated sub-tools (get_iv_radar, get_monte_carlo, etc.) when you need only a specific data dimension, to reduce latency and token usage.
Parameters
symbol : str Exchange ticker in uppercase, e.g. "NVDA", "AAPL", "SPY", "QQQ". Do NOT pass company names ("Nvidia") — use official tickers only.
Returns
dict with keys: symbol : str — normalized ticker signal : str — "Bullish" | "Bearish" | "Neutral" confidence_score: int — 0–100 directional confidence bullish_factors : list — evidence supporting an upward move bearish_factors : list — evidence supporting a downward move summary : str — one-sentence synthesis
Notes
Requires a valid HPSILAB_API_KEY.
Free-tier keys are limited to a predefined ticker set.
Response latency is ~5–15 s due to multi-model aggregation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes |