Scoring

When a tracker runs, it produces a scored result — an evidence-based assessment you can act on.

Run Result

{
  "score": 72,             // 0-100 integer
  "insight": "...",        // Detailed explanation
  "score_adjustment_factors": [ // optional
    { "factor": "Earnings momentum", "impact": 12, "probability": 0.7 }
  ]
}

---

Understanding Scores

Each tracker run produces a score (0–100 integer) and an insight (evidence and reasoning). Runs may also include score_adjustment_factors that explain how the score moved from a neutral baseline.

The agent gathers fresh evidence via skills and tools and produces factor adjustments. The engine starts from a fixed neutral baseline of 50, adds the signed factor impacts to compute the raw score, and clamps the result to 0–100. If factor payloads are partially malformed, valid factors are still used; runs fail only when no usable factors remain.

How Modes Affect Depth

Mode	Multiplier	Typical time	Best For
Basic	×1	< ~5 min	Quick answer — routine monitoring
Advanced	×6	< ~15 min	Think deeper — nuanced analysis
Super	×25	< ~50 min	Mission critical — highest reliability
Zen	×55	< ~60 min	Take your time — deepest research (async only, sync: false)

Higher modes invest more time and compute before producing a score. zen requires async execution — sync requests return 400.

Score Stability

Scores are designed to converge when the underlying situation is stable:

• No new information → score stays close to the previous value
• New information → score adjusts, and the insight explains the change
• Higher modes → deeper evidence gathering before the score moves

---

Score Distribution

Scores are grouped into 20-point range buckets for distribution analysis:

Score Range	Meaning
80 – 100	Strong positive with high certainty
60 – 80	Good outlook — worth acting on
40 – 60	Average, uncertain, or needs more data
20 – 40	Warning sign — pay attention
0 – 20	Critical with high certainty — immediate action needed

---

Receiving Results

There are several ways to stay informed when your trackers produce new results:

Method	Description
Console	View all results in real-time on your tracker's dashboard. Filter by score and date.
Email	Get an email summary each time a tracker completes a run. Enable per-tracker in notification settings.
Webhooks	Receive a run.completed POST request to your endpoint with the full result payload. Great for automating workflows.
API Polling	Use GET /api/trackers/{id}/runs to fetch results programmatically. Supports sync mode for instant results.

Setting Up Notifications

In the Console, open a tracker → Settings → Notifications to configure email alerts or webhook URLs. You can also set these via the API using notification_config when creating or updating a tracker.