Access Gold Turkey 22k (XAUTUR22) - Per Gram Exchange Rates in JSON Format for API Integration

In the rapidly evolving landscape of digital finance, the ability to access real-time exchange rates for precious metals such as gold is becoming increasingly essential for developers and businesses alike. The Metals-API provides a robust solution for retrieving exchange rates in JSON format, making it an invaluable tool for API integration. This blog post will delve into how to retrieve exchange rates for gold (XAU) and other metals, explore the capabilities of the Metals-API, and provide practical integration tips for developers.

About Gold (XAU)

Gold, represented by the symbol XAU, has long been a cornerstone of wealth and investment. In recent years, the digital transformation in precious metals has opened new avenues for data analytics and market insights. With the integration of technology in trading, developers can leverage real-time data to innovate price discovery and enhance digital asset solutions.

The Metals-API empowers developers to build next-generation applications that require accurate and timely data. By utilizing this API, businesses can gain insights into market trends, monitor fluctuations, and make informed decisions based on real-time data.

API Description

The Metals-API is designed to provide comprehensive access to metals prices and currency conversion in a user-friendly JSON format. Developers can harness the power of this API to create applications that require real-time data on precious metals, including gold, silver, platinum, and palladium. The API's capabilities include:

Real-time exchange rates: Access the latest rates for various metals updated frequently based on your subscription plan.
Historical data: Retrieve historical exchange rates dating back to 2019, allowing for in-depth market analysis.
Bid and Ask prices: Get real-time bid and ask prices for metals, which is crucial for traders.
Currency conversion: Convert amounts between different metals and currencies seamlessly.
Time-series data: Analyze trends over specific periods with daily historical rates.
Fluctuation tracking: Monitor how metal prices fluctuate over time.
Carat information: Access gold rates by carat, providing detailed insights for jewelers and investors.
OHLC data: Obtain open, high, low, and close prices for metals to assess market performance.
News updates: Stay informed with the latest news articles related to various metals.

For detailed documentation on how to use the Metals-API, visit the Metals-API Documentation.

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

The Latest Rates Endpoint provides real-time exchange rate data for all available metals. Depending on your subscription plan, the API updates this data every 60 minutes, every 10 minutes, or even more frequently. This feature is essential for applications that require up-to-the-minute pricing information.

{
"success": true,
"timestamp": 1768644463,
"base": "USD",
"date": "2026-01-17",
"rates": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"XPD": 0.000744
},
"unit": "per troy ounce"
}

The response includes a success flag, timestamp, base currency, date, and rates for various metals. Each rate is expressed per troy ounce, making it easy to integrate into financial applications.

Historical Rates Endpoint

Accessing historical rates is crucial for understanding market trends. The Historical Rates Endpoint allows you to query rates for any date since 1999. This feature is particularly useful for back-testing trading strategies or conducting market analysis.

{
"success": true,
"timestamp": 1768558063,
"base": "USD",
"date": "2026-01-16",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"unit": "per troy ounce"
}

The response format is similar to the Latest Rates Endpoint, providing a straightforward way to access historical data.

Time-Series Endpoint

The Time-Series Endpoint allows developers to retrieve exchange rates for a specific time period. This is particularly useful for analyzing trends and making predictions based on historical data.

{
"success": true,
"timeseries": true,
"start_date": "2026-01-10",
"end_date": "2026-01-17",
"base": "USD",
"rates": {
"2026-01-10": {
"XAU": 0.000485,
"XAG": 0.03825
},
"2026-01-12": {
"XAU": 0.000483,
"XAG": 0.0382
},
"2026-01-17": {
"XAU": 0.000482,
"XAG": 0.03815
}
},
"unit": "per troy ounce"
}

This endpoint provides a detailed view of how rates change over time, allowing for comprehensive analysis.

Convert Endpoint

The Convert Endpoint is a powerful feature that enables users to convert any amount from one metal to another or to/from USD. This is particularly useful for businesses that deal with multiple currencies and metals.

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

The response includes the conversion details, allowing developers to easily integrate this functionality into their applications.

Fluctuation Endpoint

Tracking rate fluctuations is essential for traders and investors. The Fluctuation Endpoint provides information about how currencies fluctuate on a day-to-day basis.

{
"success": true,
"fluctuation": true,
"start_date": "2026-01-10",
"end_date": "2026-01-17",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482,
"change": -3.0e-6,
"change_pct": -0.62
}
},
"unit": "per troy ounce"
}

This endpoint provides valuable insights into market dynamics, helping traders make informed decisions.

OHLC (Open/High/Low/Close) Endpoint

The OHLC Endpoint allows users to obtain open, high, low, and close prices for a specific time period. This data is crucial for technical analysis and understanding market trends.

{
"success": true,
"timestamp": 1768644463,
"base": "USD",
"date": "2026-01-17",
"rates": {
"XAU": {
"open": 0.000485,
"high": 0.000487,
"low": 0.000481,
"close": 0.000482
}
},
"unit": "per troy ounce"
}

By analyzing OHLC data, traders can identify potential entry and exit points for their trades.

Bid/Ask Endpoint

The Bid/Ask Endpoint provides current bid and ask prices for metals, which is essential for traders looking to execute orders at the best possible prices.

{
"success": true,
"timestamp": 1768644463,
"base": "USD",
"date": "2026-01-17",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
}
},
"unit": "per troy ounce"
}

This endpoint allows traders to make quick decisions based on the latest market data.

Integration Tips

Integrating the Metals-API into your applications can significantly enhance your data capabilities. Here are some tips for successful integration:

Understand your requirements: Before integrating, clearly define what data you need and how you plan to use it. This will help you choose the right endpoints and optimize your API calls.
Handle API responses effectively: Ensure your application can handle various response scenarios, including success, error, and empty results. Implement robust error handling to manage issues gracefully.
Optimize for performance: Be mindful of rate limits and quota management. Use caching strategies to reduce the number of API calls and improve response times.
Secure your API key: Treat your API key like a password. Do not expose it in client-side code and use server-side calls whenever possible.
Stay updated: Regularly check the Metals-API Documentation for updates and new features that can enhance your application.

Conclusion

The Metals-API offers a powerful solution for accessing real-time and historical exchange rates for precious metals, including gold (XAU). By leveraging its various endpoints, developers can create applications that provide valuable insights into market trends and facilitate informed decision-making. With features like real-time rates, historical data, and bid/ask prices, the API is an essential tool for anyone involved in trading or investing in precious metals.

For more information on supported symbols, visit the Metals-API Supported Symbols page. By integrating the Metals-API into your applications, you can stay ahead in the competitive landscape of digital finance.

Ready to use Metals-API?

Try it now!

Access Gold Turkey 22k (XAUTUR22) - Per Gram Exchange Rates in JSON Format for API Integration