x402.minara.ai

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xCF5815e9063FA0b04Be0Cb5C1DB583eeF9ef5fbB",
    "scheme": "exact",
    "network": "base",
    "mimeType": "application/json",
    "resource": "https://x402.minara.ai/x402/strategy-studio/backtest",
    "description": "Backtest an algorithmic trading strategy. Submit strategy source code (written in the TypeScript/PineScript-style DSL described by the companion strategy codegen prompt endpoint); the service statically checks it against real historical market data, then returns quantitative performance metrics — net return, Sharpe / Sortino / Calmar, max drawdown, win rate, profit factor, plus the full trade list and equity curve. Use it to create, iterate on and quantitatively evaluate trading strategies, tune parameters, and A/B compare variants. Supports crypto perpetual pairs (e.g. BTCUSDT, ETHUSDT) and US-stock pairs (e.g. AAPL-USD, GOLD-USDC).",
    "outputSchema": {
      "input": {
        "type": "http",
        "method": "POST",
        "bodyType": "json",
        "bodyFields": {
          "code": {
            "type": "string",
            "required": true,
            "description": "Full strategy source code to validate and backtest, written in the trading DSL. Call the companion strategy-codegen-prompt endpoint first if you need the language rules and API reference to generate it."
          },
          "symbol": {
            "type": "string",
            "required": false,
            "description": "Trading pair to backtest. Crypto perps (BTCUSDT, ETHUSDT, SOLUSDT) and US-stock pairs (AAPL-USD, GOLD-USDC) are supported. Default BTCUSDT. Unknown symbols fail the request."
          },
          "endTime": {
            "type": "string",
            "required": false,
            "description": "Window end date, format YYYY-MM-DD. Defaults to today when omitted."
          },
          "slippage": {
            "type": "number",
            "required": false,
            "description": "Per-fill slippage as a decimal fraction of price (0.0005 = 0.05%). Default 0 (disabled)."
          },
          "startTime": {
            "type": "string",
            "required": false,
            "description": "Window start date, format YYYY-MM-DD. Optional — auto-derived from the interval when omitted. Ranges over the 200,000-bar cap are rejected."
          },
          "runInterval": {
            "type": "string",
            "required": false,
            "description": "Bar interval. One of: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. Default 1h."
          },
          "makerFeeRate": {
            "type": "number",
            "required": false,
            "description": "Maker fee rate as a decimal fraction (0.0002 = 0.02%). Default 0 (frictionless)."
          },
          "takerFeeRate": {
            "type": "number",
            "required": false,
            "description": "Taker fee rate as a decimal fraction (0.0005 = 0.05%). Default 0 (frictionless). Set this (with makerFeeRate / slippage) for a deployability-realistic backtest."
          },
          "initialBalance": {
            "type": "number",
            "required": false,
            "description": "Starting capital in USD. Defaults to the strategy code’s declaration, otherwise 10000."
          }
        },
        "discoverable": true
      },
      "output": {
        "properties": {
          "valid": {
            "type": "boolean",
            "description": "Present and false ONLY on static-validation failure; absent on a successful run."
          },
          "errors": {
            "type": "array",
            "description": "Validation error messages (only when valid=false)."
          },
          "netPnl": {
            "type": "number",
            "description": "Net profit/loss in USD."
          },
          "status": {
            "type": "string",
            "description": "Run status: COMPLETED | FAILED (successful-run branch)."
          },
          "symbol": {
            "type": "string",
            "description": "Resolved trading pair."
          },
          "trades": {
            "type": "array",
            "description": "Round-trip trade records (one row per entry→exit), for inspecting individual fills."
          },
          "endTime": {
            "type": "string",
            "description": "Effective backtest window end."
          },
          "winRate": {
            "type": "number",
            "description": "Winning-trade percentage."
          },
          "warnings": {
            "type": "array",
            "description": "Validation warnings (only when valid=false)."
          },
          "startTime": {
            "type": "string",
            "description": "Effective backtest window start."
          },
          "timeframe": {
            "type": "string",
            "description": "Resolved bar interval."
          },
          "totalFees": {
            "type": "number",
            "description": "Total fees paid (USD) given the fee inputs."
          },
          "calmarRatio": {
            "type": "number",
            "description": "Calmar ratio."
          },
          "equityCurve": {
            "type": "array",
            "description": "Equity curve as [{ time, value }] points for plotting cumulative performance."
          },
          "sharpeRatio": {
            "type": "number",
            "description": "Sharpe ratio."
          },
          "totalTrades": {
            "type": "number",
            "description": "Total number of round-trip trades."
          },
          "finalBalance": {
            "type": "number",
            "description": "Ending equity (USD)."
          },
          "profitFactor": {
            "type": "number",
            "description": "Gross profit / gross loss."
          },
          "sortinoRatio": {
            "type": "number",
            "description": "Sortino ratio."
          },
          "netPnlPercent": {
            "type": "number",
            "description": "Net return as a percent of initial balance."
          },
          "initialBalance": {
            "type": "number",
            "description": "Starting capital used (USD)."
          },
          "maxDrawdownPercent": {
            "type": "number",
            "description": "Maximum drawdown, percent."
          },
          "buyHoldReturnPercent": {
            "type": "number",
            "description": "Buy & hold return over the same window, percent."
          },
          "strategyOutperformance": {
            "type": "number",
            "description": "Strategy return minus buy & hold, percent."
          }
        },
        "description": "On validation failure: { valid: false, errors: string[], warnings: string[] }. On success: a flat result object — performance metrics live at the TOP LEVEL (not nested under a \"metrics\" key). Key fields listed below; many more per-side / risk / trade-analysis fields are also present. Numeric metrics are null when not computable."
      }
    },
    "maxAmountRequired": "100000",
    "maxTimeoutSeconds": 300
  }
]