"Vibe-Trading: Your Personal Trading Agent"
Python ai-agentalgorithmic-tradingbacktestingfintechllmmcpmulti-agentpythonquantitative-financetrading
"""Pydantic response models shared across API route modules."""
from __future__ import annotations
from typing import Any, Dict, List, Optional
from pydantic import BaseModel, Field
class Artifact(BaseModel):
"""Artifact file metadata."""
name: str = Field(..., description="File name")
path: str = Field(..., description="File path")
type: str = Field(..., description="File type: csv, json, txt, etc.")
size: int = Field(..., description="Size in bytes")
exists: bool = Field(..., description="Whether the file exists")
class BacktestMetrics(BaseModel):
"""Backtest summary metrics."""
model_config = {"extra": "allow"}
final_value: float = Field(..., description="Ending portfolio value")
total_return: float = Field(..., description="Total return")
annual_return: float = Field(..., description="Annualized return")
max_drawdown: float = Field(..., description="Max drawdown")
sharpe: float = Field(..., description="Sharpe ratio")
win_rate: float = Field(..., description="Win rate")
trade_count: int = Field(..., description="Number of trades")
class RAGSelection(BaseModel):
"""RAG routing result."""
selected_api: str = Field(..., description="Selected API code")
selected_name: str = Field(..., description="Selected API name")
selected_score: float = Field(..., description="Match score")
class RunInfo(BaseModel):
"""Compact run row for list views."""
run_id: str
status: str
created_at: str
prompt: Optional[str] = None
total_return: Optional[float] = None
sharpe: Optional[float] = None
codes: List[str] = Field(default_factory=list)
start_date: Optional[str] = None
end_date: Optional[str] = None
class RunResponse(BaseModel):
"""API response payload for a single run."""
status: str = Field(..., description="Run status: success, failed, aborted")
run_id: str = Field(..., description="Run identifier")
elapsed_seconds: float = Field(..., description="Execution time in seconds")
reason: Optional[str] = Field(None, description="Failure reason when available")
prompt: Optional[str] = Field(None, description="Original natural-language request")
planner_output: Optional[Dict[str, Any]] = Field(None, description="Planner output")
strategy_spec: Optional[Dict[str, Any]] = Field(None, description="Strategy specification")
rag_selection: Optional[RAGSelection] = Field(None, description="Selected RAG metadata")
metrics: Optional[BacktestMetrics] = Field(None, description="Backtest metrics")
artifacts: List[Artifact] = Field(default_factory=list, description="Run artifacts")
has_factor_artifacts: bool = Field(False, description="Whether the run produced factor-analysis artifacts")
run_card: Optional[Dict[str, Any]] = Field(None, description="Trust Layer run card payload")
llm_usage: Optional[Dict[str, Any]] = Field(None, description="Provider-reported AgentLoop usage summary")
equity_curve: Optional[List[Dict[str, Any]]] = Field(None, description="Equity preview")
trade_log: Optional[List[Dict[str, Any]]] = Field(None, description="Trade preview")
artifacts_equity_csv: Optional[List[Dict[str, Any]]] = Field(None, description="Full equity rows")
artifacts_metrics_csv: Optional[List[Dict[str, Any]]] = Field(None, description="Full metrics rows")
artifacts_trades_csv: Optional[List[Dict[str, Any]]] = Field(None, description="Full trade rows")
artifacts_positions_csv: Optional[List[Dict[str, Any]]] = Field(
None, description="Actual post-execution position weights"
)
artifacts_target_positions_csv: Optional[List[Dict[str, Any]]] = Field(
None, description="Optimizer-requested target weights"
)
validation: Optional[Dict[str, Any]] = Field(None, description="Statistical validation results")
risk_xray: Optional[Dict[str, Any]] = Field(
None, description="Portfolio risk x-ray payload when the run emitted one"
)
rebalance_notes: Optional[Dict[str, Any]] = Field(
None, description="Per-rebalance weight-drift notes when the run emitted them"
)
run_directory: str = Field(..., description="Run directory path")
run_stage: Optional[str] = Field(None, description="UI-facing run stage")
run_context: Optional[Dict[str, Any]] = Field(None, description="Normalized request context")
price_series: Optional[Dict[str, List[Dict[str, Any]]]] = Field(None, description="Grouped OHLC series")
indicator_series: Optional[Dict[str, Dict[str, List[Dict[str, Any]]]]] = Field(
None,
description="Grouped indicator overlays",
)
trade_markers: Optional[List[Dict[str, Any]]] = Field(None, description="Trade markers for charts")
run_logs: Optional[List[Dict[str, Any]]] = Field(None, description="Structured stdout/stderr lines")