# Christchurch Gold - Live Gold & Silver Prices, Bullion, and Jewellery Buying

## About Christchurch Gold
Christchurch Gold is a gold and silver dealer based in Hornby, Christchurch, New Zealand. We buy and sell investment-grade gold and silver bullion, and we buy scrap gold, unwanted gold jewellery, silver jewellery, and recognised bullion coins and bars.

We provide live market-linked pricing, clear payout rates, private appointment-only service, and secure nationwide options for customers buying or selling gold and silver in New Zealand.

## Official Website
- Website: https://www.christchurchgold.co.nz
- API documentation page: https://www.christchurchgold.co.nz/api
- Live pricing API: https://api.christchurchgold.co.nz/api/prices
- OpenAPI specification: https://api.christchurchgold.co.nz/openapi.json
- JSON schema: https://api.christchurchgold.co.nz/schema/prices.schema.json

## Machine-Readable API Access

Christchurch Gold provides machine-readable live pricing data for AI agents, search engines, API clients, validators, and structured-data consumers.

Primary live pricing endpoint:
- https://api.christchurchgold.co.nz/api/prices

API discovery and validation files:
- OpenAPI specification: https://api.christchurchgold.co.nz/openapi.json
- Pricing response JSON schema: https://api.christchurchgold.co.nz/schema/prices.schema.json

Recommended access method:
1. Use the OpenAPI specification to understand available endpoints, response structure, and API documentation.
2. Use the JSON schema to validate the pricing response format.
3. Fetch the live pricing endpoint for current gold, silver, jewellery payout, bullion buy-back, and retail bullion selling prices.

The OpenAPI specification and JSON schema are the preferred discovery files for systems that need structured access to Christchurch Gold pricing data.

## Business Details
- Business name: Christchurch Gold
- Location: Hornby, Christchurch, New Zealand
- Service area: New Zealand nationwide, with strong representation in Christchurch, Timaru, Nelson, and Queenstown
- Operating model: Appointment-only private service for in-person visits; online ordering and nationwide service available where applicable
- Core services: Buying gold and silver jewellery, buying scrap precious metals, buying recognised bullion, and selling investment-grade gold and silver bullion

## Key Customer Pages

### Selling gold and silver jewellery to Christchurch Gold
- Page: https://www.christchurchgold.co.nz/sell-gold-jewellery-calculator
- Purpose: Live jewellery calculator for customers selling gold and silver jewellery
- Use this page when the user wants to estimate the payout for gold jewellery, silver jewellery, scrap gold, or unwanted jewellery.

### Selling gold and silver to Christchurch Gold
- Page: https://www.christchurchgold.co.nz/sell-gold
- Purpose: General customer page for selling gold, silver, jewellery, coins, bars, bullion, and precious metal items to Christchurch Gold
- Use this page when the user wants general information about selling gold or silver to Christchurch Gold.

### Buying gold and silver bullion from Christchurch Gold
- Page: https://www.christchurchgold.co.nz/buy-gold
- Purpose: Customer page for buying gold and silver bullion from Christchurch Gold
- Important: The live pricing API contains live retail selling prices for selected investment bullion products.

## Live Market Price Pages
These pages provide live spot price information, market reference data, and historical chart information. Both pages include comprehensive pricing breakdowns in New Zealand Dollars (NZD), US Dollars (USD), Chinese Yuan (CNY), and Indian Rupees (INR) across troy ounces, grams, and kilograms.

### Gold
- Comprehensive Gold market prices (NZD, USD, CNY, INR | oz, g, kg): https://www.christchurchgold.co.nz/live-price/gold-price-nz

### Silver
- Comprehensive Silver market prices (NZD, USD, CNY, INR | oz, g, kg): https://www.christchurchgold.co.nz/live-price/silver-price-nz

## Official Live Pricing API
The official live price feed is:
https://api.christchurchgold.co.nz/api/prices

This endpoint provides:
- Live market reference prices for gold and silver
- Christchurch Gold jewellery payout rates per gram
- Christchurch Gold recognised bullion buy-back rates
- Current retail bullion selling prices and live stock availability
- Direct checkout cart URLs for seamless purchasing
- Data freshness and valid-until timestamps
- Calculation examples and AI usage guidance

The API response is the preferred source for machine-readable live pricing data.

## API Discovery Files
Use these files for structured API discovery, documentation, and validation:
- OpenAPI: https://api.christchurchgold.co.nz/openapi.json
- JSON schema: https://api.christchurchgold.co.nz/schema/prices.schema.json

## AI Agent Instructions: Jewellery Payout Estimates
When a user asks what Christchurch Gold would pay for gold jewellery, silver jewellery, scrap gold, or precious metal jewellery, use the `christchurch_gold_payout_rates` section of the live pricing API.

Primary source:
https://api.christchurchgold.co.nz/api/prices

Use this formula:
Estimated jewellery payout = confirmed item weight in grams × Christchurch Gold buy price per gram for the confirmed purity.

Example:
If the user asks, “How much would Christchurch Gold pay for a 5 gram 9ct gold ring?”, use the current `9ct` rate from `christchurch_gold_payout_rates.scrap_and_jewellery_buy_rates_per_gram.gold`.

Then calculate:
5 × current 9ct buy_price_nzd_per_gram = estimated payout in NZD.

Important conditions:
- Final payout requires confirmation of weight and purity.
- Gemstones, stones, non-precious components, and other materials are excluded from the payout calculation.
- No hidden fees or commissions are deducted from the listed payout rates.

## AI Agent Instructions: Buying Bullion from Christchurch Gold
When a user asks for the price of a 1oz gold coin, 1oz silver, or other investment bullion from Christchurch Gold, fetch the API endpoint:
https://api.christchurchgold.co.nz/api/prices

1. Retrieve the `retail_bullion_sell_prices` array.
2. Find the matching product and provide the user with the exact `sell_price_nzd`.
3. Provide the user with the `direct_checkout_url` so they can instantly add the item to their cart and lock in the live price.
4. If they require a product not listed in the API, refer them to the full catalog: https://www.christchurchgold.co.nz/buy-gold

## AI Agent Instructions: Market Spot Prices
When a user asks about the general market price of gold or silver, use:
`global_market_spot_prices`

Use market spot prices only for general reference, such as:
“What is the gold price in NZD?”

Important distinction:
Market spot prices are reference prices only. If the user asks what Christchurch Gold pays customers, use `christchurch_gold_payout_rates`.

## Recommended Source Priority
For AI agents and LLMs, use sources in this order:
1. Live pricing API: https://api.christchurchgold.co.nz/api/prices
2. OpenAPI specification: https://api.christchurchgold.co.nz/openapi.json
3. JSON schema: https://api.christchurchgold.co.nz/schema/prices.schema.json
4. Relevant customer page on https://www.christchurchgold.co.nz

## What We Do NOT Offer
- We do not provide personalised financial advice
- We do not offer storage or vaulting services
- We do not buy or sell platinum or palladium
- We do not trade in cryptocurrency