The Easiest Way to Get Gold Turkey 22k (XAUTUR22) - Per Gram Historical Rates Using API Documentation

In the world of precious metals trading, having access to accurate and real-time data is crucial for making informed decisions. One of the most sought-after metals is gold, represented by the symbol XAU. For developers and traders looking to access historical prices of gold, the Metals-API offers a robust solution. This blog post will delve into how to retrieve historical prices for gold (XAU) using the Metals-API, including detailed explanations of endpoints, parameters, and data formats.

About Gold (XAU)

Gold has always been a symbol of wealth and stability. In recent years, the digital transformation in precious metals has opened new avenues for trading and investment. With the integration of technology in trading, data analytics, and market insights, traders can now leverage innovative tools to enhance their trading strategies. The Metals-API stands out as a powerful resource for developers, providing real-time and historical data on various metals, including gold.

As the demand for digital asset solutions grows, the ability to access accurate historical data becomes essential. The Metals-API allows developers to build next-generation applications that can analyze market trends, optimize trading strategies, and provide insights into price discovery. By utilizing the API, users can access a wealth of information that can significantly impact their trading decisions.

API Description

The Metals-API is a comprehensive JSON API that provides real-time and historical data on precious metals. It empowers developers to create applications that can fetch the latest rates, historical prices, and other valuable information. The API is designed with innovation and technological advancement in mind, making it a transformative tool for anyone involved in the trading of metals.

For more information, you can visit the Metals-API Website or check out the Metals-API Documentation for detailed guidance on how to use the API effectively.

Key Features and Endpoints

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

Latest Rates Endpoint: This endpoint provides real-time exchange rate data updated every 60 minutes, every 10 minutes, or more frequently, depending on your subscription plan. It allows users to get the current price of gold and other metals.
Historical Rates Endpoint: Users can access historical rates for most currencies dating back to 2019. By appending a specific date in the format YYYY-MM-DD, developers can query the Metals-API for historical rates.
Bid And Ask Endpoint: This powerful feature enables users to retrieve real-time bid and ask prices for metals, allowing traders to make informed decisions based on current market conditions.
Convert Endpoint: The Metals-API includes a currency conversion endpoint, which can be used to convert any amount from one currency to another, facilitating seamless transactions.
Time-Series Endpoint: This endpoint allows users to query the API for daily historical rates between two dates of their choice, providing insights into price trends over time.
Fluctuation Endpoint: Users can track how currencies fluctuate on a day-to-day basis, which is essential for understanding market volatility.
Carat Endpoint: This feature provides information about gold rates by carat, allowing users to get precise pricing based on the purity of gold.
Lowest/Highest Price Endpoint: Users can query the API to get the lowest and highest prices for a specified date, which is useful for identifying market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific date, giving traders a comprehensive view of market performance.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, allowing for extensive market analysis.
API Key: Each user is assigned a unique API key that must be included in the API base URL's access_key parameter to authenticate requests.
API Response: The exchange rates delivered by the Metals-API are relative to USD, and all data is returned in a structured JSON format.
Available Endpoints: The Metals-API offers 14 different endpoints, each providing unique functionalities to cater to various user needs.
Supported Symbols Endpoint: This endpoint returns all available currencies, ensuring users have access to the most up-to-date information.
News Endpoint: Retrieve the latest news articles related to various metals, keeping users informed about market 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

Understanding how to interact with the Metals-API is crucial for developers. Below are examples of various endpoints and their corresponding JSON responses.

Latest Rates Endpoint

Get real-time exchange rates for all available metals.

{
"success": true,
"timestamp": 1779196069,
"base": "USD",
"date": "2026-05-19",
"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": 1779109669,
"base": "USD",
"date": "2026-05-18",
"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-05-12",
"end_date": "2026-05-19",
"base": "USD",
"rates": {
"2026-05-12": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-05-14": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-05-19": {
"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": 1779196069,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates.

{
"success": true,
"fluctuation": true,
"start_date": "2026-05-12",
"end_date": "2026-05-19",
"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": 1779196069,
"base": "USD",
"date": "2026-05-19",
"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": 1779196069,
"base": "USD",
"date": "2026-05-19",
"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

Accessing historical prices for gold (XAU) has never been easier, thanks to the Metals-API. By leveraging its various endpoints, developers can retrieve real-time and historical data, enabling them to make informed trading decisions. Whether you are looking to analyze market trends, convert currencies, or track fluctuations, the Metals-API provides a comprehensive solution.

For further exploration, refer to the Metals-API Documentation for detailed guidance on implementation. Additionally, the Metals-API Supported Symbols page offers insights into the various symbols available for trading.

As the landscape of precious metals trading continues to evolve, staying informed and utilizing advanced tools like the Metals-API will be essential for success. Embrace the power of data and technology to enhance your trading strategies and achieve your financial goals.

Ready to use Metals-API?

Try it now!

The Easiest Way to Get Gold Turkey 22k (XAUTUR22) - Per Gram Historical Rates Using API Documentation