{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-response-meta-schema.json",
  "title": "ResponseMeta",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-content-api-openapi.yml#/components/schemas/ResponseMeta",
  "type": "object",
  "required": [
    "request_id",
    "cached",
    "cost"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "description": "Unique request ID (req_ prefix). The same value as the X-Request-Id response header, the request's usage accounting row and its log lines."
    },
    "cached": {
      "type": "boolean"
    },
    "cache_age_s": {
      "type": "integer",
      "description": "Cache age in seconds. Omitted when the response was not cached, and also when it was cached but its age cannot be established (an entry stored before its cache carried a computed instant). Never a placeholder: an unknown age is reported as no value rather than as the cache TTL."
    },
    "cost": {
      "type": "integer",
      "description": "Advisory request weight (relative compute cost). 1 for simple reads; higher for heavier endpoints. Not a credit/price."
    },
    "ranking_generation": {
      "type": "integer",
      "description": "Committed PostgreSQL-owned leaderboard generation for the returned rows and cursor. Present on GET /api/v1/leaderboard; omitted on endpoints that do not read this ranking."
    },
    "ranking_as_of": {
      "type": "string",
      "format": "date-time",
      "description": "Authoritative RFC3339 timestamp from cache_generations.updated_at for ranking_generation. It is read in the same repeatable-read snapshot as the leaderboard rows and is not request time, cache write time, or row insertion order."
    },
    "directional_source": {
      "type": "string",
      "enum": [
        "live",
        "degraded"
      ],
      "description": "Directional evidence provenance for Edge Hunter signals collections. The default board carries this provenance in data.directional_source and omits this optional meta field."
    },
    "ranking_source": {
      "type": "string",
      "enum": [
        "live",
        "db_only"
      ],
      "description": "Ranking evidence provenance for Edge Hunter signals collections. The default board carries this clock/provenance in data.ranking_source and omits this optional meta field."
    },
    "category_skill_source": {
      "type": "string",
      "enum": [
        "live",
        "partial",
        "degraded",
        "unavailable"
      ],
      "description": "Whole filtered snapshot category-evidence status before pagination. Operational live always remains partial source coverage."
    },
    "category_skill_model_version": {
      "type": "string"
    },
    "category_skill_taxonomy_version": {
      "type": "string"
    },
    "category_skill_platform": {
      "type": "string",
      "const": "polymarket"
    },
    "category_skill_scope": {
      "type": "string",
      "const": "observed_goldsky_primary_taker_fill"
    },
    "category_skill_source_coverage": {
      "type": "string",
      "enum": [
        "partial_whale_threshold_fills",
        "graded_wallet_fills"
      ]
    },
    "category_skill_observation_started_at": {
      "type": "string",
      "format": "date-time"
    },
    "category_skill_model_operationally_degraded": {
      "type": "boolean",
      "description": "Whole-model operational readiness captured with the category model snapshot. Present on category-enriched responses even when the filtered signal list is empty. When true, category_skill_source is degraded and Edge Hunter signals uses the shorter degraded cache TTL."
    },
    "category_skill_status_counts": {
      "type": "object",
      "required": [
        "live",
        "insufficient",
        "stale",
        "unknown",
        "degraded"
      ],
      "properties": {
        "live": {
          "type": "integer",
          "minimum": 0
        },
        "insufficient": {
          "type": "integer",
          "minimum": 0
        },
        "stale": {
          "type": "integer",
          "minimum": 0
        },
        "unknown": {
          "type": "integer",
          "minimum": 0
        },
        "degraded": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "category_skill_base_payload_hash": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$",
      "description": "SHA-256 of the funded signal membership/order/rank/cursor vector immediately before category-skill enrichment. Edge Hunter signals view only."
    },
    "category_skill_enriched_base_payload_hash": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$",
      "description": "Independent SHA-256 recomputation over the same base fields immediately after category-skill enrichment. Equality with category_skill_base_payload_hash proves category-skill enrichment did not change funded inputs. Edge Hunter signals view only."
    }
  }
}