GET /v1/edge/backtest

$0.05dailytier: deepcache 86400sEngine C — Weather × Markets Edge

Aggregates stored edge signals whose markets have resolved: how often the model beat the market (hit rate), average absolute-error improvement (edge captured), a model calibration curve, and per-hazard breakdowns. model_label is explicit about which model produced the signals.

Parameters

Example

curl "https://x402-factory.com/v1/edge/backtest?window=90"

Example response

Worked example from deterministic fixture data (note meta.data_mode); live responses report their own sources and data_mode.

{
  "data": {
    "n_signals": 1228,
    "hit_rate": 0.503,
    "avg_edge_captured": 0.0022,
    "calibration_curve": [
      {
        "bucket": "0.0–0.1",
        "predicted": 0.05,
        "realized": 0.055
      },
      {
        "bucket": "0.2–0.3",
        "predicted": 0.25,
        "realized": 0.26
      },
      {
        "bucket": "0.5–0.6",
        "predicted": 0.55,
        "realized": 0.548
      },
      {
        "bucket": "0.8–0.9",
        "predicted": 0.85,
        "realized": 0.849
      },
      {
        "bucket": "0.9–1.0",
        "predicted": 0.9,
        "realized": 0.3
      }
    ],
    "by_hazard": [
      {
        "hazard": "temp_above",
        "n": 584,
        "hit_rate": 0.521
      },
      {
        "hazard": "any_precip",
        "n": 292,
        "hit_rate": 0.483
      },
      {
        "hazard": "named_storm_landfall",
        "n": 292,
        "hit_rate": 0.455
      },
      {
        "hazard": "wind_above",
        "n": 60,
        "hit_rate": 0.667
      }
    ],
    "model_label": "stub-model"
  },
  "meta": {
    "endpoint": "/v1/edge/backtest",
    "version": "1.0.0",
    "generated_at": "2026-10-05T10:15:57.768Z",
    "freshness": "daily",
    "sources": [
      "stub-model",
      "kalshi",
      "polymarket"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/edge.backtest",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "n_signals": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "hit_rate": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "avg_edge_captured": {
      "type": "number"
    },
    "calibration_curve": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "bucket": {
            "type": "string"
          },
          "predicted": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "realized": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          }
        },
        "required": [
          "bucket",
          "predicted",
          "realized"
        ],
        "additionalProperties": false
      }
    },
    "by_hazard": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "hazard": {
            "type": "string"
          },
          "n": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "hit_rate": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          }
        },
        "required": [
          "hazard",
          "n",
          "hit_rate"
        ],
        "additionalProperties": false
      }
    },
    "model_label": {
      "type": "string"
    }
  },
  "required": [
    "n_signals",
    "hit_rate",
    "avg_edge_captured",
    "calibration_curve",
    "by_hazard",
    "model_label"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.05 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors