{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-data-quality-schema.json",
  "title": "DataQuality",
  "description": "Compact data age and coverage for a response body, always present on the operations that publish it. Read status and as_of to decide whether to use the body at all, and field_groups to see which part is weak. Everything here comes from stored observation clocks, so a cached body reports the same ages a freshly computed one does: meta.cached and meta.cache_age_s stay the only transport-time facts and neither makes this block newer. The per-field audit object is still available through expand=trust; this is the default summary of the same question.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-large-trades-api-openapi.yml#/components/schemas/DataQuality",
  "type": "object",
  "required": [
    "status",
    "field_groups"
  ],
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "fresh",
        "partial",
        "unknown",
        "untracked",
        "unavailable"
      ],
      "description": "fresh when every group is fresh, unavailable when every group is unavailable, and partial in every other case."
    },
    "as_of": {
      "type": "string",
      "format": "date-time",
      "description": "The oldest as_of among the groups that carry one: the age of the weakest clock this body rests on. Omitted when no group carries a clock."
    },
    "field_groups": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/DataQualityGroup"
      },
      "description": "One entry per field group. Entries may be added in later releases, so match on group rather than on position or length."
    }
  },
  "$defs": {
    "DataQualityGroup": {
      "type": "object",
      "description": "One group of response fields that share a writer and therefore share a clock.",
      "required": [
        "group",
        "owner",
        "status"
      ],
      "properties": {
        "group": {
          "type": "string",
          "description": "Stable snake_case group name. Names are additive across releases, so match on the ones you know and ignore the rest."
        },
        "owner": {
          "type": "string",
          "description": "The table and column that write this group, named so the verdict can be audited (for example trader_rankings.computed_at)."
        },
        "status": {
          "type": "string",
          "enum": [
            "fresh",
            "partial",
            "unknown",
            "untracked",
            "unavailable"
          ],
          "description": "fresh: served, and as_of carries this group's real observation or computation clock. partial: some of the group's fields are served and some are missing. unknown: served, and this read has no clock for it, so no age may be inferred. untracked: 0xinsider does not track this group for this subject, by design. unavailable: the group could not be served. New values may be added; treat one you do not recognize as unknown. fresh means the group is tracked and clocked, not that it is inside any particular tolerance: compare as_of against your own."
        },
        "as_of": {
          "type": "string",
          "format": "date-time",
          "description": "When this group's values were observed or computed. Omitted whenever the read cannot measure it, and never filled with the serialization time, the cache time, or another group's clock."
        },
        "reason": {
          "type": "string",
          "description": "Why the status is not fresh. Omitted when it is."
        }
      }
    }
  }
}