Access China Gold SGE AM (XAUCHNAM) - Per Gram Conversion API Exchange Rates in JSON Format

In the rapidly evolving landscape of precious metals trading, the ability to access real-time data is crucial for developers and traders alike. The Metals-API provides a robust solution for retrieving Gold (XAU) exchange rates in JSON format, enabling seamless integration into applications. This blog post will explore the capabilities of the Metals-API, focusing on its innovative features, detailed API responses, and practical integration tips for developers looking to harness the power of real-time metals data.

About Gold (XAU)

Gold has long been regarded as a safe haven asset and a store of value. In recent years, the digital transformation in precious metals trading has opened new avenues for data analytics and market insights. The integration of technology in trading has revolutionized price discovery and created innovative digital asset solutions. As developers, understanding these dynamics is essential for building applications that can leverage real-time data effectively.

The Metals-API stands at the forefront of this transformation, offering developers the tools needed to create next-generation applications that can respond to market fluctuations and provide users with accurate pricing information. With its comprehensive set of endpoints, the Metals-API allows for a wide range of functionalities, from retrieving the latest rates to historical data analysis.

API Description

The Metals-API is designed to empower developers by providing access to real-time and historical metals data. With a focus on innovation and technological advancement, this API enables users to build applications that can analyze market trends, track fluctuations, and convert between different metal currencies. The API's capabilities extend beyond simple data retrieval; it offers a transformative potential for developers looking to create sophisticated trading platforms.

For more detailed information, developers can refer to the Metals-API Documentation, which provides comprehensive guidelines on how to utilize the API effectively.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs in the realm of metals trading. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for various metals, updated every 60 minutes, 10 minutes, or even more frequently, depending on your subscription plan. This feature is essential for applications that require up-to-the-minute pricing information.
Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your query. This functionality is invaluable for developers looking to analyze trends over time and make informed trading decisions.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing traders to gauge market sentiment and make timely decisions based on current pricing dynamics.
Convert Endpoint: This endpoint enables the conversion of any amount from one metal to another or to/from USD. It simplifies the process of calculating the value of metals in different currencies, making it easier for users to understand their investments.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice. This feature is particularly useful for developers looking to create visualizations or reports based on historical data.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, providing insights into market volatility and helping traders make informed decisions.
Carat Endpoint: Retrieve information about Gold rates by Carat, allowing for precise calculations based on the purity of gold being traded.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date, which can assist in identifying market trends and making strategic trading decisions.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides the open, high, low, and close prices for a specific time period, offering a comprehensive view of market performance.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a wealth of data for analysis and reporting.
API Key: Your unique API key is required to access the API, ensuring secure and authorized usage.
API Response: Exchange rates are delivered relative to USD by default, with all data returned in a structured JSON format.
Available Endpoints: The Metals-API includes 14 different endpoints, each offering unique functionalities to meet diverse trading needs.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals, ensuring you have the latest information at your fingertips.

List of Symbols

The API provides access to a comprehensive range of metal symbols. For a complete list of all supported symbols and their specifications, refer to the Metals-API Supported Symbols page.

API Endpoint Examples and Responses

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1784999240,
"base": "USD",
"date": "2026-07-25",
"rates": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"XPD": 0.000744,
"XCU": 0.294118,
"XAL": 0.434783,
"XNI": 0.142857,
"XZN": 0.344828
},
"unit": "per troy ounce"
}

Historical Rates Endpoint

Access historical exchange rates for any date since 1999:

{
"success": true,
"timestamp": 1784912840,
"base": "USD",
"date": "2026-07-24",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}

Time-series Endpoint

Get exchange rates for a specific time period:

{
"success": true,
"timeseries": true,
"start_date": "2026-07-18",
"end_date": "2026-07-25",
"base": "USD",
"rates": {
"2026-07-18": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-07-20": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-07-25": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

Convert Endpoint

Convert any amount from one metal to another or to/from USD:

{
"success": true,
"query": {
"from": "USD",
"to": "XAU",
"amount": 1000
},
"info": {
"timestamp": 1784999240,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-07-18",
"end_date": "2026-07-25",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482,
"change": -3.0e-6,
"change_pct": -0.62
},
"XAG": {
"start_rate": 0.03825,
"end_rate": 0.03815,
"change": -0.0001,
"change_pct": -0.26
},
"XPT": {
"start_rate": 0.000915,
"end_rate": 0.000912,
"change": -3.0e-6,
"change_pct": -0.33
}
},
"unit": "per troy ounce"
}

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period:

{
"success": true,
"timestamp": 1784999240,
"base": "USD",
"date": "2026-07-25",
"rates": {
"XAU": {
"open": 0.000485,
"high": 0.000487,
"low": 0.000481,
"close": 0.000482
},
"XAG": {
"open": 0.03825,
"high": 0.0383,
"low": 0.0381,
"close": 0.03815
},
"XPT": {
"open": 0.000915,
"high": 0.000918,
"low": 0.00091,
"close": 0.000912
}
},
"unit": "per troy ounce"
}

Bid/Ask Endpoint

Get current bid and ask prices for metals:

{
"success": true,
"timestamp": 1784999240,
"base": "USD",
"date": "2026-07-25",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
},
"XAG": {
"bid": 0.0381,
"ask": 0.0382,
"spread": 0.0001
},
"XPT": {
"bid": 0.000911,
"ask": 0.000913,
"spread": 2.0e-6
}
},
"unit": "per troy ounce"
}

Conclusion

In conclusion, the Metals-API offers a powerful suite of tools for developers looking to access real-time and historical Gold (XAU) exchange rates in JSON format. With its extensive range of endpoints, developers can retrieve the latest rates, historical data, and perform conversions with ease. The API's innovative features enable the creation of sophisticated applications that can respond to market changes and provide valuable insights to users.

For those interested in diving deeper into the capabilities of the Metals-API, the Metals-API Documentation is an invaluable resource. Additionally, the Metals-API Supported Symbols page provides a comprehensive list of available symbols, ensuring developers have the information they need at their fingertips.

As the market for precious metals continues to evolve, leveraging real-time data through APIs like Metals-API will be essential for developers and traders alike. By integrating these capabilities into their applications, they can unlock new opportunities for analysis, trading, and investment in the precious metals market.

Ready to use Metals-API?

Try it now!

Access China Gold SGE AM (XAUCHNAM) - Per Gram Conversion API Exchange Rates in JSON Format