CertusAI Unified API Reference (v19.4)

# CertusAI Unified API (v19.4) ## Overview The CertusAI API provides a secure, internal-only interface for the `Innora` frontend and other authorized agents to interact with the core trading engine. It exposes real-time PnL, position data, and market sentiment analysis. **Base URL**: `http://certusai-core:8000` (Internal Docker Network) --- ## Endpoints ### 1. Dashboard Status **GET** `/api/v1/dashboard` Returns the high-level health and performance metrics of the engine. **Response** ```json { "status": "operational", "pnl_percent": "+24.8%", "active_pairs": ["ETHUSDT"], "confidence": 0.85, "latency": "23ms" } ``` ### 2. Fortress Positions **GET** `/fortress/positions` Detailed breakdown of current active positions managed by the `sac_ultra_eth` strategy. **Response** ```json [ { "symbol": "ETHUSDT", "side": "LONG", "entry_price": 2850.50, "unrealized_pnl": 450.20, "leverage": 5 } ] ``` ### 3. Market State **GET** `/market/state/{symbol}` Returns the aggregated feature vector and AI confidence score for a specific asset. **Parameters** - `symbol`: e.g., `ETHUSDT`, `BTCUSDT` --- ## Authentication Currently restricted to internal Docker network `innora-net`. Future versions will implement JWT-based auth via the `Titan` gateway.