How to Get Real-Time Gold Turkey 21k (XAUTUR21) - Per Gram Prices with Metals-API

In today's fast-paced financial landscape, accessing real-time market data is crucial for making informed investment decisions, especially in the precious metals sector. The Metals-API provides a powerful solution for developers looking to integrate real-time gold prices, including the specific rates for Gold Turkey 21k (XAUTUR21), into their applications. This blog post will guide you through the process of accessing real-time market prices using the Metals-API, offering step-by-step instructions and example API calls.

Understanding Gold (XAU)

Gold, represented by the symbol XAU, has long been a cornerstone of wealth and investment. As a digital transformation sweeps through the financial sector, the integration of technology in trading precious metals is becoming increasingly important. The Metals-API not only provides real-time data but also empowers developers to harness data analytics and market insights for better decision-making.

With the rise of digital asset solutions, understanding the dynamics of gold pricing is essential. The Metals-API allows users to explore innovative price discovery methods, enabling traders to react swiftly to market changes. By leveraging this API, developers can create applications that provide users with the most accurate and timely information available.

Getting Started with Metals-API

To access real-time gold prices, you first need to sign up for an account on the Metals-API Website. After registration, you will receive an API key, which is essential for making requests to the API. This key must be included in each API call to authenticate your requests.

Key Features of Metals-API

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 for metals, updated every 60 minutes, every 10 minutes, or more frequently depending on your subscription plan.
Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your API call.
Bid and Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing traders to make informed decisions based on current market conditions.
Convert Endpoint: Convert any amount from one metal to another or to/from USD, facilitating easy transactions.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, providing insights into price trends over time.
Fluctuation Endpoint: Track how metal prices fluctuate on a day-to-day basis, which is crucial for understanding market volatility.
Carat Endpoint: Retrieve information about gold rates by carat, which is particularly useful for jewelers and consumers.
Lowest/Highest Price Endpoint: Get the lowest and highest prices for a specified date, helping traders identify market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Access open, high, low, and close prices for a specific time period, essential for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, useful for comprehensive market analysis.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market developments.

Making API Calls

Once you have your API key, you can start making requests to the Metals-API. Below are examples of how to use some of the key endpoints.

Latest Rates Endpoint

To get real-time exchange rates for all available metals, you can use the following API call:

GET https://metals-api.com/api/latest?access_key=YOUR_API_KEY

Example response:

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

Historical Rates Endpoint

To access historical exchange rates for any date since 1999, you can use:

GET https://metals-api.com/api/historical?access_key=YOUR_API_KEY&date=YYYY-MM-DD

Example response:

{
"success": true,
"timestamp": 1769041563,
"base": "USD",
"date": "2026-01-22",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825
},
"unit": "per troy ounce"
}

Time-Series Endpoint

To get exchange rates for a specific time period, use the following:

GET https://metals-api.com/api/timeseries?access_key=YOUR_API_KEY&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD

Example response:

{
"success": true,
"timeseries": true,
"start_date": "2026-01-16",
"end_date": "2026-01-23",
"base": "USD",
"rates": {
"2026-01-16": {
"XAU": 0.000485
},
"2026-01-23": {
"XAU": 0.000482
}
},
"unit": "per troy ounce"
}

Convert Endpoint

To convert any amount from one metal to another or to/from USD, you can use:

GET https://metals-api.com/api/convert?access_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

Example response:

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

Fluctuation Endpoint

To track rate fluctuations between two dates, use:

GET https://metals-api.com/api/fluctuation?access_key=YOUR_API_KEY&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD

Example response:

{
"success": true,
"fluctuation": true,
"start_date": "2026-01-16",
"end_date": "2026-01-23",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482
}
},
"unit": "per troy ounce"
}

Open/High/Low/Close (OHLC) Price Endpoint

To get OHLC data for a specific time period, use:

GET https://metals-api.com/api/open-high-low-close?access_key=YOUR_API_KEY&date=YYYY-MM-DD

Example response:

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

Bid/Ask Endpoint

To get current bid and ask prices for metals, use:

GET https://metals-api.com/api/bid-ask?access_key=YOUR_API_KEY

Example response:

{
"success": true,
"timestamp": 1769127963,
"base": "USD",
"date": "2026-01-23",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483
}
},
"unit": "per troy ounce"
}

Understanding API Responses

Each API response contains several fields that provide valuable information:

success: Indicates whether the API call was successful.
timestamp: The time at which the data was retrieved.
base: The base currency for the exchange rates.
date: The date for which the rates are applicable.
rates: An object containing the exchange rates for various metals.
unit: The unit of measurement for the rates, typically per troy ounce.

Understanding these fields is crucial for developers as they build applications that rely on accurate and timely data. For more detailed information about each endpoint and its parameters, refer to the Metals-API Documentation.

Common Use Cases

The Metals-API can be utilized in various applications, including:

Investment Platforms: Integrate real-time gold prices into trading platforms to provide users with the latest market data.
Financial Analysis Tools: Use historical data to analyze trends and make predictions about future price movements.
E-commerce: Allow users to convert prices of gold jewelry into different currencies seamlessly.
Market Research: Gather data on price fluctuations to inform investment strategies and market insights.

Performance Optimization and Best Practices

When working with the Metals-API, consider the following best practices for performance optimization:

Rate Limiting: Be mindful of your API usage to avoid hitting rate limits. Optimize your calls by caching results where appropriate.
Error Handling: Implement robust error handling to manage failed requests gracefully and provide fallback mechanisms.
Data Validation: Ensure that all data received from the API is validated before use to prevent errors in your application.
Security: Always keep your API key secure and avoid exposing it in client-side code.

Conclusion

Accessing real-time gold prices, such as those for Gold Turkey 21k (XAUTUR21), has never been easier thanks to the Metals-API. By following the steps outlined in this guide, developers can integrate powerful features into their applications, providing users with the most accurate and timely data available. With endpoints for real-time rates, historical data, and conversion capabilities, the Metals-API is a versatile tool for anyone looking to navigate the precious metals market.

For further exploration of the API's capabilities, be sure to check out the Metals-API Supported Symbols page, and dive deeper into the Metals-API Documentation for comprehensive details on each endpoint. By leveraging these resources, you can unlock the full potential of real-time metals data and enhance your trading strategies.

Ready to use Metals-API?

Try it now!

How to Get Real-Time Gold Turkey 21k (XAUTUR21) - Per Gram Prices with Metals-API