{
  "openapi": "3.1.0",
  "info": {
    "title": "BetScout Quantitative Sports Edge & Score Intelligence API",
    "version": "1.0.0",
    "description": "Commercial REST API providing calibrated multi-sport probabilities, Dixon-Coles exact-score & tennis set-score dutching matrices, 2-leg uncorrelated parlays, bookmaker mispricing dislocations, and verified paper-betting ledger attribution."
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      },
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    },
    {
      "BearerAuth": []
    }
  ],
  "paths": {
    "/api/v1/picks": {
      "get": {
        "summary": "List upcoming high-conviction picks across all 10 sports (Starter+)",
        "parameters": [
          {
            "name": "sport",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "all"
            }
          },
          {
            "name": "min_odds",
            "in": "query",
            "schema": {
              "type": "number",
              "default": 1.15
            }
          }
        ]
      }
    },
    "/api/v1/ledger": {
      "get": {
        "summary": "Get verified settled paper-betting ledger, ROI, CLV & sport/tier attribution (Starter+)"
      }
    },
    "/api/v1/dutching": {
      "get": {
        "summary": "Get 28-score Dixon-Coles & tennis set-score equal-payout dutching matrices (Pro+)",
        "parameters": [
          {
            "name": "stake",
            "in": "query",
            "schema": {
              "type": "number",
              "default": 25.0
            }
          }
        ]
      }
    },
    "/api/v1/combos": {
      "get": {
        "summary": "Get recommended 2-leg high-probability combos & parlays across 4 archetypes (Pro+)"
      }
    },
    "/api/v1/mispriced": {
      "get": {
        "summary": "Get confirmed bookmaker odds mispricings (>= +2.0pp edge & >= +2.0% EV) (Pro+)"
      }
    },
    "/api/v1/analyze": {
      "get": {
        "summary": "Run on-demand live matchup analysis for any Tennis or Football pair (Pro+)",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    }
  }
}