Access Graphite Africa (AF-GR) Exchange Rates API Documentation in JSON Format

In the rapidly evolving landscape of financial technology, the ability to retrieve real-time exchange rates for metals is crucial for developers and businesses alike. The Metals-API provides a robust solution for accessing exchange rates in JSON format, enabling seamless integration into applications. This blog post will guide you through retrieving {Symbol} exchange rates using the Metals-API, showcasing sample API responses and offering integration tips to enhance your development experience.

Understanding Metals-API

The Metals-API is a powerful tool designed to provide developers with real-time and historical exchange rate data for various metals. With a focus on technological innovation and advancement, this API empowers users to build next-generation applications that leverage real-time data analytics and insights. The API supports a wide range of functionalities, allowing for comprehensive data retrieval and manipulation.

For more information on the API's capabilities, visit the Metals-API Website or check out the Metals-API Documentation.

About Tellurium (TE)

Tellurium (TE) is a lesser-known metal that plays a significant role in various technological applications, particularly in the realm of digital transformation. As industries increasingly adopt smart technology, the demand for metals like Tellurium is expected to rise. This shift is driven by the need for advanced materials in electronics, renewable energy, and other high-tech sectors.

Technological innovation in metal markets is reshaping how we understand and utilize these resources. Data analytics and insights derived from real-time metals data can provide businesses with a competitive edge, allowing them to make informed decisions based on market trends and fluctuations. As we look to the future, the integration of smart technology in metal trading will likely lead to more efficient and transparent markets.

Key Features of Metals-API

The Metals-API offers a variety of endpoints, each designed to cater to specific needs. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated based on your subscription plan. Depending on the plan, updates can occur every 60 minutes or even every 10 minutes.
Historical Rates Endpoint: Access historical exchange rates dating back to 2019. By appending a specific date to your query, you can retrieve past rates for analysis.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing for precise trading strategies.
Convert Endpoint: Convert any amount from one metal to another or to/from USD, facilitating easy transactions.
Time-Series Endpoint: Query daily historical rates between two dates, providing insights into trends over time.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, helping to identify patterns and make predictions.
Carat Endpoint: Get information about gold rates by carat, useful for jewelers and investors.
Lowest/Highest Price Endpoint: Query the API to find the lowest and highest prices for a specified date.
Open/High/Low/Close (OHLC) Price Endpoint: Retrieve OHLC data for a specific time period, essential for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, useful for market analysis.
API Key: Your unique API key is required for authentication and must be included in your requests.
API Response: Exchange rates are delivered relative to USD by default, with all data returned in JSON format.
Supported Symbols Endpoint: Get a constantly updated list of all available currencies and metals.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market developments.

Retrieving Exchange Rates for {Symbol}

To retrieve exchange rates for a specific metal symbol, such as XAU (Gold), XAG (Silver), XPT (Platinum), or XPD (Palladium), you can utilize the Metals-API's endpoints effectively. Below are examples of how to use various endpoints to access the data you need.

Latest Rates Endpoint

To get real-time exchange rates for all available metals, you can use the latest rates endpoint. Here’s a sample response:

{
"success": true,
"timestamp": 1764720578,
"base": "USD",
"date": "2025-12-03",
"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"
}

This response indicates the current exchange rates for various metals relative to USD. The "rates" object contains the exchange rate for each metal symbol, allowing developers to integrate this data into their applications seamlessly.

Historical Rates Endpoint

Accessing historical exchange rates is straightforward. By appending a date to your request, you can retrieve past rates. Here’s an example response:

{
"success": true,
"timestamp": 1764634178,
"base": "USD",
"date": "2025-12-02",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}

This response provides the exchange rates for the specified date, allowing for historical analysis and trend identification.

Time-Series Endpoint

The time-series endpoint allows you to query exchange rates for a specific period. Here’s a sample response:

{
"success": true,
"timeseries": true,
"start_date": "2025-11-26",
"end_date": "2025-12-03",
"base": "USD",
"rates": {
"2025-11-26": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2025-11-28": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2025-12-03": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

This endpoint is particularly useful for analyzing trends over time, as it provides daily rates for the specified period.

Convert Endpoint

To convert amounts between different metals or to/from USD, the convert endpoint is invaluable. Here’s an example response:

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

This response shows the conversion of 1000 USD to gold (XAU), providing the rate and the resulting amount in troy ounces.

Fluctuation Endpoint

The fluctuation endpoint allows you to track rate changes between two dates. Here’s a sample response:

{
"success": true,
"fluctuation": true,
"start_date": "2025-11-26",
"end_date": "2025-12-03",
"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"
}

This endpoint provides insights into how rates have changed over time, which can be critical for making informed trading decisions.

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

For technical analysis, the OHLC endpoint is essential. Here’s a sample response:

{
"success": true,
"timestamp": 1764720578,
"base": "USD",
"date": "2025-12-03",
"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"
}

This response provides the opening, highest, lowest, and closing prices for the specified date, which are crucial for traders analyzing market behavior.

Bid/Ask Endpoint

To get current bid and ask prices for metals, use the bid/ask endpoint. Here’s a sample response:

{
"success": true,
"timestamp": 1764720578,
"base": "USD",
"date": "2025-12-03",
"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"
}

This endpoint provides the current bid and ask prices, along with the spread, which is essential for traders looking to execute orders efficiently.

Integration Tips

When integrating the Metals-API into your applications, consider the following tips:

Authentication: Always include your API key in the access_key parameter of your requests to ensure secure access.
Rate Limiting: Be mindful of your subscription plan's rate limits to avoid disruptions in service. Implement error handling to manage rate limit responses gracefully.
Data Caching: To optimize performance, consider caching responses where appropriate, especially for data that does not change frequently.
Error Handling: Implement robust error handling to manage various response scenarios, including success, error, and empty results.
Security Best Practices: Ensure that your API key is kept secure and not exposed in client-side code. Use server-side requests whenever possible.

Conclusion

The Metals-API provides a comprehensive solution for accessing real-time and historical exchange rates for metals in JSON format. By leveraging its various endpoints, developers can build powerful applications that utilize real-time data for trading, analysis, and decision-making. With features like the latest rates, historical data, conversion capabilities, and fluctuation tracking, the API is an invaluable resource for anyone working in the metals market.

For further exploration, refer to the Metals-API Documentation for detailed information on each endpoint, and check the Metals-API Supported Symbols for a complete list of available metal symbols. Embrace the power of real-time metals data and transform your applications today!

Ready to use Metals-API?

Try it now!

Access Graphite Africa (AF-GR) Exchange Rates API Documentation in JSON Format