Portfolio Backtest API

# Submit a backtest
curl -X POST "https://api.stratiumsol.com/v1/backtest/run" \
  -H "X-API-Key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      { "address": "7xKXLkq...9bPq", "allocation": 0.6, "slippageBps": 50 },
      { "address": "4mNpT2k...3vRw", "allocation": 0.4, "slippageBps": 50 }
    ],
    "capital": { "solAmount": 100 },
    "period": { "start": "2026-01-01", "end": "2026-04-01" },
    "sizing": { "mode": "PERCENTAGE", "positionCapPercent": 5 }
  }'

# Poll for results
curl "https://api.stratiumsol.com/v1/backtest/bt_abc123" \
  -H "X-API-Key: sk_live_your_key"

const API_KEY = process.env.STRATIUM_API_KEY!;
const BASE = "https://api.stratiumsol.com/v1";
const headers = { "X-API-Key": API_KEY, "Content-Type": "application/json" };

// Submit backtest
const { data: job } = await fetch(`${BASE}/backtest/run`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    wallets: [
      { address: "7xKXLkq...9bPq", allocation: 0.6, slippageBps: 50 },
      { address: "4mNpT2k...3vRw", allocation: 0.4, slippageBps: 50 },
    ],
    capital: { solAmount: 100 },
    period: { start: "2026-01-01", end: "2026-04-01" },
    sizing: { mode: "PERCENTAGE", positionCapPercent: 5 },
  }),
}).then((r) => r.json());

// Poll until complete
let result;
do {
  await new Promise((r) => setTimeout(r, 2000));
  result = await fetch(`${BASE}/backtest/${job.backtest_id}`, { headers })
    .then((r) => r.json());
} while (result.data.status === "running");

console.log(`ROI: ${result.data.roi_percent}%`);

import os, time, requests

API_KEY = os.environ["STRATIUM_API_KEY"]
BASE = "https://api.stratiumsol.com/v1"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

# Submit backtest
job = requests.post(f"{BASE}/backtest/run", headers=HEADERS, json={
    "wallets": [
        {"address": "7xKXLkq...9bPq", "allocation": 0.6, "slippageBps": 50},
        {"address": "4mNpT2k...3vRw", "allocation": 0.4, "slippageBps": 50},
    ],
    "capital": {"solAmount": 100},
    "period": {"start": "2026-01-01", "end": "2026-04-01"},
    "sizing": {"mode": "PERCENTAGE", "positionCapPercent": 5},
}).json()

# Poll until complete
while True:
    result = requests.get(f"{BASE}/backtest/{job['data']['backtest_id']}", headers=HEADERS).json()
    if result["data"]["status"] != "running":
        break
    time.sleep(2)

print(f"ROI: {result['data']['roi_percent']}%")

interface BacktestResult {
  backtest_id: string;              // Unique identifier (bt_*)
  status: "pending" | "running"
        | "completed" | "failed";
  progress_percent: number;         // 0-100 during execution
  wallets: string[];                // Input wallet addresses
  capital_sol: number;              // Starting capital
  period_start: string;             // ISO 8601
  period_end: string;               // ISO 8601
  sizing_mode: string;              // FIXED_SIZE | PERCENTAGE
  total_trades: number;             // Trades simulated
  successful_trades: number;
  failed_trades: number;
  final_pnl_sol: number;            // Cumulative realized PnL
  roi_percent: number;              // PnL / max_capital_deployed
  roi_annualized_percent: number;   // Annualized ROI
  max_capital_deployed_sol: number; // Peak capital in positions
  max_drawdown_percent: number;     // Worst peak-to-trough
  win_rate_percent: number;         // % profitable sells
  profit_factor: number;            // Gross profit / gross loss
  sharpe_ratio: number;             // Risk-adjusted return
  best_trade_pnl_sol: number;
  worst_trade_pnl_sol: number;
  median_trade_pnl_sol: number;
  created_at: string;               // ISO 8601
  completed_at: string | null;      // ISO 8601
}

{
  "success": true,
  "data": {
    "backtest_id": "bt_abc123",
    "status": "completed",
    "progress_percent": 100,
    "wallets": ["7xKXLkq...9bPq", "4mNpT2k...3vRw"],
    "capital_sol": 100,
    "period_start": "2026-01-01T00:00:00Z",
    "period_end": "2026-04-01T00:00:00Z",
    "sizing_mode": "PERCENTAGE",
    "total_trades": 342,
    "successful_trades": 338,
    "failed_trades": 4,
    "final_pnl_sol": 28.4,
    "roi_percent": 22.1,
    "roi_annualized_percent": 88.4,
    "max_capital_deployed_sol": 128.5,
    "max_drawdown_percent": 8.2,
    "win_rate_percent": 68.4,
    "profit_factor": 2.84,
    "sharpe_ratio": 1.42,
    "best_trade_pnl_sol": 12.6,
    "worst_trade_pnl_sol": -3.2,
    "median_trade_pnl_sol": 0.08,
    "created_at": "2026-04-14T12:00:00Z",
    "completed_at": "2026-04-14T12:00:32Z"
  },
  "timestamp": "2026-04-14T12:01:00Z"
}