Access Gold Turkey 21k (XAUTUR21) Exchange Rates API Documentation in JSON Format

In the world of finance, the ability to retrieve real-time exchange rates for precious metals is crucial for traders, investors, and developers alike. The Metals-API provides a comprehensive solution for accessing exchange rates in JSON format, specifically for metals like Gold (XAU), Silver (XAG), Platinum (XPT), and Palladium (XPD). This blog post will delve into how to retrieve Gold exchange rates using the Metals-API, including sample API responses and integration tips.

About Gold (XAU)

Gold has long been a symbol of wealth and stability, making it a popular asset in financial markets. With the digital transformation of precious metals trading, data analytics and market insights have become more accessible than ever. The integration of technology in trading has revolutionized how investors approach the market, allowing for innovative price discovery and digital asset solutions.

The Metals-API empowers developers to build next-generation applications that leverage real-time metals data. By utilizing this API, you can access a wealth of information that can enhance trading strategies, improve market analysis, and provide valuable insights into price movements.

API Description

The Metals-API is designed to provide developers with a robust set of tools for accessing precious metals data. With capabilities that include real-time exchange rates, historical data, and conversion features, this API is a powerful resource for anyone looking to integrate metals data into their applications. The API is accessible via a simple RESTful interface, making it easy to retrieve the data you need.

For more detailed information, you can refer to the Metals-API Documentation, which outlines all available endpoints and their functionalities.

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: Depending on your subscription plan, this endpoint returns real-time exchange rate data updated every 60 minutes, every 10 minutes, or even more frequently. This allows you to stay on top of market fluctuations and make informed trading decisions.
Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. You can query the API for historical rates by appending a date to your request, enabling you to analyze trends over time.
Bid And Ask Endpoint: This powerful feature allows you to retrieve real-time Bid and Ask prices for metals, providing insight into market liquidity and pricing dynamics.
Convert Endpoint: The conversion endpoint enables you to convert any amount from one currency to another, facilitating seamless transactions and calculations.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, allowing for in-depth analysis of price movements over time.
Fluctuation Endpoint: Retrieve information about how currencies fluctuate on a day-to-day basis, helping you understand market volatility.
Carat Endpoint: Access information about Gold rates by Carat, which is particularly useful for jewelers and those in the jewelry industry.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specified date, providing insights into market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Get the open, high, low, and close price for a specific time period, which is essential for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, allowing for comprehensive market analysis.
API Key: Your unique API Key is essential for accessing the API, ensuring secure and authorized usage.
API Response: Exchange rates delivered by the Metals-API are by default relative to USD, providing a consistent basis for comparison.
Available Endpoints: The API includes 14 endpoints, each providing different functionalities to meet various user needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, ensuring you have access to the latest data.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you 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

Latest Rates Endpoint

Get real-time exchange rates for all available metals.

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

Fluctuation Endpoint

Track rate fluctuations between two dates.

{
"success": true,
"fluctuation": true,
"start_date": "2026-02-05",
"end_date": "2026-02-12",
"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": 1770872869,
"base": "USD",
"date": "2026-02-12",
"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": 1770872869,
"base": "USD",
"date": "2026-02-12",
"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 powerful and flexible solution for accessing real-time and historical exchange rates for precious metals like Gold (XAU). By leveraging the various endpoints available, developers can create applications that offer valuable insights into market trends, facilitate trading, and enhance financial analysis.

With features such as the Latest Rates, Historical Rates, and Conversion endpoints, the API caters to a wide range of use cases, from simple currency conversions to complex market analyses. The comprehensive documentation available at the Metals-API Documentation ensures that developers can easily implement these features into their applications.

For those looking to explore the full range of supported symbols, the Metals-API Supported Symbols page provides an up-to-date list of all available currencies. By integrating the Metals-API into your projects, you can harness the power of real-time metals data and stay ahead in the ever-evolving financial landscape.

Ready to use Metals-API?

Try it now!

Access Gold Turkey 21k (XAUTUR21) Exchange Rates API Documentation in JSON Format