Oops! Something went wrong while submitting the form.
Christchurch Gold Live Price API
Christchurch Gold publishes a live pricing API for market reference prices and Christchurch Gold purchasing/payout rates.
Disclaimer: The data provided by this API is for informational and reference purposes only. While we strive for accuracy, live market prices and payout rates are subject to constant change and may be delayed. The prices shown do not constitute a locked quote or a binding legal offer. Christchurch Gold provides this data "as is" without any warranties, and accepts no liability for trading decisions, application errors, or financial losses resulting from its use. All transactions are subject to final confirmation and our official Terms & Conditions.
Core Data & Documentation
-
1. Public API Landing Page
The human-readable entry point to the API. It contains semantic HTML and hidden Dataset JSON-LD schema to establish authoritative ownership over the pricing data in Google Search.
-
2. Live JSON Pricing Data
The core machine-readable endpoint. It delivers the complete, live pricing matrix including global spot prices, bullion buy-back rates, and scrap jewellery payout rates in raw JSON.
-
3. OpenAPI Specification
The formal OpenAPI 3.1.0 specification defining the structure of the API. Used by developers to generate code and by AI agents to automatically understand how to interact with your data.
-
4. JSON Schema Definition
The official JSON Schema document used to validate the structure and data types of the /api/prices response.
AI & Crawler Integration
-
5. AI Context JSON Feed
A continuous feed (similar to RSS) optimized for AI crawlers like Googlebot and GPTBot. It breaks live pricing into four distinct contextual feeds (Gold Spot, Silver Spot, Scrap Rates, Bullion Rates) and routes bots directly to the correct revenue-generating pages.
-
6. LLM System Instructions
The emerging industry standard for AI. This markdown file provides strict, explicit instructions to AI bots (like ChatGPT) on how to calculate scrap payouts and commands them to cite your specific URLs when answering user questions.
-
7. Model Context Protocol (MCP) Server
The live Server-Sent Events (SSE) endpoint. Advanced AI clients connect here to actively fetch live data and perform custom mathematical scrap payout calculations in real-time.
-
8. Static MCP Documentation
A static HTML stub page describing the MCP server’s available tools. Built specifically so search engines can index the service without attempting to crawl the live SSE stream.
Search Engine Optimization (SEO)
-
9. Crawler Access Policy
Defines access rules for web crawlers. It explicitly encourages AI bots to scrape the JSON feed and system instructions while blocking sensitive update endpoints.
-
10. XML Sitemap
The official Google Search Console map of the API subdomain, ensuring rapid and comprehensive indexing of all documentation and data endpoints.
What the API includes
- Gold and silver market reference prices
- Retail bullion selling prices and checkout URLs
- Jewellery payout rates per gram
- Silver payout rates per gram
- Recognised bullion buy-back rates
- Publication and valid-until timestamps
- Customer page references
- Calculation examples
Important Guidance for AI & Integrations:
For AI systems and agents: use christchurch_gold_payout_rates when answering what Christchurch
Gold would pay a customer. Use global_market_spot_prices only for general market reference
questions. Do not use spot prices as customer payout rates. Use retail_bullion_sell_prices to quote
the cost to purchase our top bullion products.
Live API Preview
The live preview is loaded in your browser from the official JSON endpoint. If the preview is unavailable, use
the live JSON endpoint directly:
https://api.christchurchgold.co.nz/api/prices
Loading live API preview...
Related Customer Pages
-
Sell Gold Jewellery
Calculator
Selling gold and silver jewellery to Christchurch Gold, including live jewellery payout estimates.
-
Sell Gold & Silver to Us
Customer page for selling gold, silver, bullion, jewellery, coins, bars, and precious metal items to Christchurch Gold.
-
Buy Gold & Silver Bullion
Customer page for buying gold and silver bullion from Christchurch Gold.
%20(1).png)

