SymbolDataTypeCoverage Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "SymbolDataTypeCoverage",
  "description": "Coverage for a symbol and data type",
  "type": "object",
  "required": [
    "completeness",
    "earliest",
    "gaps",
    "latest",
    "total_records"
  ],
  "properties": {
    "cadence": {
      "description": "Empirical data cadence measurement (present when sufficient data exists)",
      "nullable": true,
      "allOf": [
        {
          "description": "Empirical data cadence measurement based on last 7 days of data",
          "type": "object",
          "required": [
            "median_interval_seconds",
            "p95_interval_seconds",
            "sample_count"
          ],
          "properties": {
            "median_interval_seconds": {
              "description": "Median interval between consecutive records in seconds",
              "type": "number"
            },
            "p95_interval_seconds": {
              "description": "95th percentile interval between consecutive records in seconds",
              "type": "number"
            },
            "sample_count": {
              "description": "Number of intervals sampled for this measurement",
              "type": "integer",
              "format": "int64"
            }
          }
        }
      ]
    },
    "completeness": {
      "description": "24-hour completeness percentage (0-100)",
      "type": "number"
    },
    "earliest": {
      "type": "string",
      "format": "date-time"
    },
    "gaps": {
      "description": "Detected data gaps within the requested time window",
      "type": "array",
      "items": {
        "description": "A gap in data coverage",
        "type": "object",
        "required": [
          "duration_minutes",
          "end",
          "start"
        ],
        "properties": {
          "duration_minutes": {
            "description": "Gap duration in minutes",
            "type": "integer"
          },
          "end": {
            "description": "End of gap (first data after gap)",
            "type": "string",
            "format": "date-time"
          },
          "start": {
            "description": "Start of gap (last data before gap)",
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "historical_coverage": {
      "description": "Historical coverage percentage (0-100) based on hours with data / total hours in range",
      "type": "number",
      "nullable": true
    },
    "latest": {
      "type": "string",
      "format": "date-time"
    },
    "total_records": {
      "type": "integer",
      "format": "int64"
    }
  }
}