{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.christchurchgold.co.nz/schema/prices.schema.json",
  "title": "Christchurch Gold Pricing Schema",
  "description": "Strict payload schema definition for the Christchurch Gold pricing API. Designed for AI interoperability.",
  "type": "object",
  "required": [
    "meta",
    "important_notice",
    "global_market_spot_prices",
    "christchurch_gold_payout_rates",
    "calculation_examples",
    "retail_bullion_sell_prices"
  ],
  "properties": {
    "meta": {
      "type": "object",
      "description": "Technical metadata and E-E-A-T signals for the API payload.",
      "required": ["publication_time_utc", "publication_time_local", "valid_until_utc"],
      "properties": {
        "provider": { "type": "string" },
        "base_currency": { "type": "string" },
        "publication_time_utc": { "type": "string", "format": "date-time" },
        "publication_time_local": { "type": "string", "format": "date-time" },
        "valid_until_utc": { "type": "string", "format": "date-time" }
      },
      "additionalProperties": true
    },
    "important_notice": {
      "type": "object",
      "description": "Legal disclosures, terms, and quote lock information.",
      "additionalProperties": true
    },
    "global_market_spot_prices": {
      "type": "object",
      "description": "Live reference spot prices from the global market.",
      "additionalProperties": true
    },
    "christchurch_gold_payout_rates": {
      "type": "object",
      "description": "Actual guaranteed payout rates offered by Christchurch Gold for jewellery and bullion.",
      "additionalProperties": true
    },
    "calculation_examples": {
      "type": "array",
      "description": "Sample calculations designed specifically to train LLMs on how to calculate customer payouts.",
      "items": { "type": "object", "additionalProperties": true }
    },
    "retail_bullion_sell_prices": {
      "type": "object",
      "description": "Current retail selling prices for our physical bullion products.",
      "additionalProperties": true
    },
    "customer_pages": {
      "type": "object",
      "description": "Optional index of relevant customer-facing web pages.",
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}