backtesting-trading-strategies

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: backtesting-trading-strategies
description: 'Backtest crypto and traditional trading strategies against historical
  data.

  Calculates performance metrics (Sharpe, Sortino, max drawdown), generates equity
  curves,

  and optimizes strategy parameters. Use when user wants to test a trading strategy,

  validate signals, or compare approaches.

  Trigger with phrases like "backtest strategy", "test trading strategy", "historical
  performance",

  "simulate trades", "optimize parameters", or "validate signals".

  '
allowed-tools: Read, Write, Edit, Grep, Glob, Bash(python:*)
version: 1.28.0
author: Jeremy Longshore <[email protected]>
license: MIT
tags:
- crypto
- testing
- performance
compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
---
# Backtesting Trading Strategies

## Overview

Validate trading strategies against historical data before risking real capital. This skill provides a complete backtesting framework with 8 built-in strategies, comprehensive performance metrics, and parameter optimization.

**Key Features:**

- 8 pre-built trading strategies (SMA, EMA, RSI, MACD, Bollinger, Breakout, Mean Reversion, Momentum)
- Full performance metrics (Sharpe, Sortino, Calmar, VaR, max drawdown)
- Parameter grid search optimization
- Equity curve visualization
- Trade-by-trade analysis

## Prerequisites

Install required dependencies:

```bash
set -euo pipefail
pip install pandas numpy yfinance matplotlib
```

Optional for advanced features:

```bash
set -euo pipefail
pip install ta-lib scipy scikit-learn
```

## Instructions

1. Fetch historical data (cached to `${CLAUDE_SKILL_DIR}/data/` for reuse):

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/fetch_data.py --symbol BTC-USD --period 2y --interval 1d
   ```

2. Run a backtest with default or custom parameters:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/backtest.py --strategy sma_crossover --symbol BTC-USD --period 1y
   python ${CLAUDE_SKILL_DIR}/scripts/backtest.py \
     --strategy rsi_reversal \
     --symbol ETH-USD \
     --period 1y \
     --capital 10000 \  # 10000: 10 seconds in ms
     --params '{"period": 14, "overbought": 70, "oversold": 30}'
   ```

3. Analyze results saved to `${CLAUDE_SKILL_DIR}/reports/` -- includes `*_summary.txt` (performance metrics), `*_trades.csv` (trade log), `*_equity.csv` (equity curve data), and `*_chart.png` (visual equity curve).
4. Optimize parameters via grid search to find the best combination:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/optimize.py \
     --strategy sma_crossover \
     --symbol BTC-USD \
     --period 1y \
     --param-grid '{"fast_period": [10, 20, 30], "slow_period": [50, 100, 200]}'  # HTTP 200 OK
   ```

## Output

### Performance Metrics

| Metric | Description |
|--------|-------------|
| Total Return | Overall percentage gain/loss |
| CAGR | Compound annual growth rate |
| Sharpe Ratio | Risk-adjusted return (target: >1.5) |
| Sortino Ratio | Downside risk-adjusted return |
| Calmar Ratio | Return divided by max drawdown |

### Risk Metrics

| Metric | Description |
|--------|-------------|
| Max Drawdown | Largest peak-to-trough decline |
| VaR (95%) | Value at Risk at 95% confidence |
| CVaR (95%) | Expected loss beyond VaR |
| Volatility | Annualized standard deviation |

### Trade Statistics

| Metric | Description |
|--------|-------------|
| Total Trades | Number of round-trip trades |
| Win Rate | Percentage of profitable trades |
| Profit Factor | Gross profit divided by gross loss |
| Expectancy | Expected value per trade |

### Example Output

```
================================================================================
                    BACKTEST RESULTS: SMA CROSSOVER
                    BTC-USD | [start_date] to [end_date]
================================================================================
 PERFORMANCE                          | RISK
 Total Return:        +47.32%         | Max Drawdown:      -18.45%
 CAG