Access Gold Turkey 21k (XAUTUR21) - Per Gram API Response Format in JSON Format

In the evolving landscape of precious metals trading, the ability to access real-time data is paramount for developers and traders alike. The Metals-API offers a robust solution for retrieving Gold (XAU) exchange rates in JSON format, empowering users to integrate this data into their applications seamlessly. This blog post delves into the capabilities of the Metals-API, focusing on its innovative features, detailed API responses, and practical integration tips for developers.

About Gold (XAU)

Gold has long been a symbol of wealth and stability, and in today's digital age, it is undergoing a transformation through technology. The integration of data analytics and market insights into precious metals trading is revolutionizing how investors approach the market. With the rise of digital asset solutions, the demand for accurate and timely data has never been higher. The Metals-API stands at the forefront of this digital transformation, providing developers with the tools to harness real-time metals data for innovative applications.

API Description

The Metals-API is designed to deliver real-time and historical data on precious metals, including Gold (XAU). This API allows developers to build next-generation applications that can analyze market trends, track price fluctuations, and convert currencies with ease. By leveraging the power of real-time data, developers can create solutions that enhance trading strategies and improve decision-making processes.

For more information, visit the Metals-API Website or explore the Metals-API Documentation for comprehensive guidance on implementation.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs in the precious metals market. Each endpoint provides unique functionalities that can be utilized for various applications. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for precious metals, updated based on your subscription plan. Depending on the plan, updates can occur every 60 minutes or even every 10 minutes, ensuring that you have the most current data at your fingertips.
Historical Rates Endpoint: Access historical exchange rates dating back to 2019. By appending a specific date in the format YYYY-MM-DD, developers can retrieve past rates, allowing for in-depth market analysis and trend identification.
Bid And Ask Endpoint: This feature enables users to retrieve real-time bid and ask prices for metals, which is crucial for traders looking to make informed decisions based on current market conditions.
Convert Endpoint: The conversion endpoint allows for seamless currency conversions, enabling users to convert any amount from one currency to another, including conversions to and from USD.
Time-Series Endpoint: Query the API for daily historical rates between two specified dates. This endpoint is particularly useful for analyzing trends over time and understanding market movements.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis. This endpoint provides insights into market volatility, helping traders to strategize effectively.
Carat Endpoint: Retrieve Gold rates by carat, which is essential for jewelers and those in the jewelry industry who need precise measurements for their products.
Lowest/Highest Price Endpoint: This endpoint allows users to query the API for the lowest and highest prices of metals over a specified period, aiding in market analysis and investment decisions.
Open/High/Low/Close (OHLC) Price Endpoint: Get detailed OHLC data for specific time periods, which is vital for traders looking to analyze price movements and make informed trading decisions.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a wealth of data for analysis and research.
API Key: Your unique API key is essential for accessing the API and must be included in the base URL's access_key parameter.
API Response: The Metals-API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format.
Available Endpoints: The API includes 14 endpoints, each offering different functionalities to cater to diverse user needs.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals, ensuring you have the latest information at your disposal.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market trends and developments.

List of Symbols

The Metals-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": 1776463632,
"base": "USD",
"date": "2026-04-17",
"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": 1776377232,
"base": "USD",
"date": "2026-04-16",
"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-04-10",
"end_date": "2026-04-17",
"base": "USD",
"rates": {
"2026-04-10": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-04-12": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-04-17": {
"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": 1776463632,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-04-10",
"end_date": "2026-04-17",
"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": 1776463632,
"base": "USD",
"date": "2026-04-17",
"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": 1776463632,
"base": "USD",
"date": "2026-04-17",
"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

The Metals-API provides a comprehensive solution for developers looking to access real-time and historical data on precious metals, particularly Gold (XAU). With its wide range of endpoints, including the latest rates, historical data, and conversion capabilities, the API empowers users to build innovative applications that can analyze market trends and enhance trading strategies.

By leveraging the power of the Metals-API, developers can create applications that not only provide real-time data but also offer insights into market fluctuations and historical trends. This capability is essential for making informed decisions in the fast-paced world of precious metals trading.

For more information on how to implement these features, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols for a complete list of available metals. Embrace the future of precious metals trading with the Metals-API and unlock the potential of real-time data in your applications.

Ready to use Metals-API?

Try it now!

Access Gold Turkey 21k (XAUTUR21) - Per Gram API Response Format in JSON Format