{
  "openapi": "3.1.0",
  "info": {
    "title": "Christchurch Gold Pricing API",
    "description": "Live gold and silver purchasing rates, bullion buy-back rates, scrap jewellery payout rates, and market reference prices. We proudly serve New Zealand customers, especially in Christchurch, Nelson, Timaru, and Queenstown.",
    "version": "1.0.0",
    "contact": {
      "name": "Christchurch Gold",
      "url": "https://www.christchurchgold.co.nz?utm_source=api_site&utm_medium=referral"
    },
    "x-logo": {
      "url": "https://cdn.prod.website-files.com/676bc93dc0d75728455c893b/6a10e835139752f854b678e9_chch-gold-logo-web-tab%20(1).svg"
    },
    "x-apisguru-categories": [
      "financial"
    ]
  },
  "servers": [
    {
      "url": "https://api.christchurchgold.co.nz",
      "description": "Production API"
    }
  ],
  "externalDocs": {
    "description": "Christchurch Gold Official Website",
    "url": "https://www.christchurchgold.co.nz?utm_source=api_site&utm_medium=referral"
  },
  "paths": {
    "/api/prices": {
      "get": {
        "operationId": "getLivePrices",
        "summary": "Retrieve live pricing data",
        "description": "Fetches the most recent live spot prices, bullion buy-back rates, and scrap jewellery payout rates for gold and silver.",
        "tags": [
          "Pricing"
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the full pricing matrix.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PricesResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PricesResponse": {
        "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
      }
    }
  },
  "tags": [
    {
      "name": "Pricing",
      "description": "Live bullion, precious metal, and jewellery payout pricing."
    }
  ]
}