> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predictaa.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Risk profiles

# Feature: Risk Profiles (A1 Archetype Integration)

**Status**: ✅ Implemented
**Date**: 2026-01-30

## Overview

The Predicta Bot now includes a "System 1" personality layer. Instead of forcing users to configure complex parameters (Stop Loss %, Max Bet Size, Confidence Threshold), the bot automatically inherits the user's **Preon Archetype**.

This archetype is determined during the user's onboarding quiz (A1 Metric) and stored in their Firestore profile.

## The Three Profiles

### 1. The Guardian (Owl 🦉)

* **Philosophy**: "Capital Preservation First."
* **Best For**: Conservative investors, steady growth.
* **Behavior**:
  * **Strict Gates**: Only trades when AI confidence is **> 85%**.
  * **No Hype**: Rejects Momentum/Chase strategies.
  * **No Shorting**: Only buys "Value".
  * **Small Sizing**: Cuts position sizes by **50% (0.5x)**.
  * **Risk**: Low.

### 2. The Strategist (Wolf 🐺)

* **Philosophy**: "Balance in all things."
* **Best For**: Standard users, balanced portfolio.
* **Behavior**:
  * **Standard Gates**: AI confidence **> 65%**.
  * **Balanced**: Takes both Momentum and Value trades.
  * **Shorting**: Allowed.
  * **Standard Sizing**: 1.0x Multiplier.
  * **Risk**: Medium.

### 3. The Maverick (Shark 🦈)

* **Philosophy**: "Fortune favors the bold."
* **Best For**: Degens, high tolerance for drawdowns.
* **Behavior**:
  * **Loose Gates**: AI confidence **> 55%**.
  * **Aggressive**: Loves Volatility and Hype.
  * **Big Bets**: Doubles position sizes **(2.0x)**.
  * **Risk**: High.

## Technical Implementation

### Data Flow

1. **Cortex Trader (`cortex_trader.py`)**:
   * At the start of every cycle, fetches `users/{user_id}` from Firestore.
   * Extracts `archetype` field (wolf/owl/shark).
   * Maps to `RiskProfile` string.
2. **Market Brain (`alpha.py`)**:
   * Receives `RiskProfile` in `analyze_market()`.
   * Sets internal constants (`MIN_CONFIDENCE`, `MAX_THETA`, `RISK_MULTIPLIER`) based on profile.
3. **Execution (`oracle.py`)**:
   * Executes trade with the calculated size.

## Defaults

If a user has no profile or the fetch fails, the system defaults to **Strategist (Wolf)** to ensure balanced performance.
