BreadthCounts Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "BreadthCounts",
  "description": "Auditable counts behind an aggregate Hyperliquid core perpetual or HIP-3 breadth snapshot.",
  "type": "object",
  "required": [
    "above",
    "at",
    "below",
    "candidates",
    "eligible",
    "excluded_no_session_volume",
    "excluded_stale_price"
  ],
  "properties": {
    "above": {
      "description": "Eligible instruments trading above their current UTC-session VWAP.",
      "type": "integer",
      "format": "int32",
      "minimum": 0
    },
    "at": {
      "description": "Eligible instruments at their current UTC-session VWAP.",
      "type": "integer",
      "format": "int32",
      "minimum": 0
    },
    "below": {
      "description": "Eligible instruments trading below their current UTC-session VWAP.",
      "type": "integer",
      "format": "int32",
      "minimum": 0
    },
    "candidates": {
      "description": "Cumulative candidate instruments considered at this calculation cutoff. This is not a fixed inventory, and candidate counts are not guaranteed to be monotonic across historical snapshots.",
      "type": "integer",
      "format": "int32",
      "minimum": 0
    },
    "eligible": {
      "description": "Eligible instruments included in the headline percentage.",
      "type": "integer",
      "format": "int32",
      "minimum": 0
    },
    "excluded_no_session_volume": {
      "description": "Candidates excluded because the current UTC session has no qualifying volume.",
      "type": "integer",
      "format": "int32",
      "minimum": 0
    },
    "excluded_stale_price": {
      "description": "Candidates with session volume excluded because their most recent completed 1-minute candle close was older than the 5-minute freshness threshold at the calculation cutoff. Candidates without session volume are counted only in excluded_no_session_volume.",
      "type": "integer",
      "format": "int32",
      "minimum": 0
    }
  }
}