{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-large-trade-history-meta-schema.json",
  "title": "LargeTradeHistoryMeta",
  "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/LargeTradeHistoryMeta",
  "type": "object",
  "required": [
    "request_id",
    "cached",
    "source",
    "completeness"
  ],
  "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; the key is absent when the response was not cached."
    },
    "source": {
      "type": "object",
      "required": [
        "kind",
        "table",
        "provider_fetch_at_request_time"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "const": "local_replay"
        },
        "table": {
          "type": "string",
          "const": "whale_alerts"
        },
        "provider_fetch_at_request_time": {
          "type": "boolean",
          "const": false
        }
      }
    },
    "completeness": {
      "type": "object",
      "required": [
        "status",
        "reason"
      ],
      "properties": {
        "status": {
          "type": "string",
          "const": "best_effort"
        },
        "reason": {
          "type": "string",
          "description": "Explains that local replay completeness can vary by market and time window."
        }
      }
    }
  }
}