Access Madurai Gold 22k (MADU-22k) API Integration Guide for JSON Format
Access Madurai Gold 22k (MADU-22k) API Integration Guide for JSON Format
In the rapidly evolving world of precious metals trading, having access to real-time data is crucial for developers and businesses looking to innovate and stay competitive. The Metals-API provides a robust solution for retrieving Gold (XAU) exchange rates in JSON format, enabling developers to integrate precious metals data into their applications seamlessly. This guide will explore the capabilities of the Metals-API, focusing on how to effectively retrieve and utilize Gold exchange rates, along with sample API responses and integration tips.
Metals-API Information
About Gold (XAU)
Gold, represented by the symbol XAU, has long been a cornerstone of the global financial system. As a precious metal, it serves not only as a store of value but also as a hedge against inflation and currency fluctuations. The digital transformation in precious metals trading has opened new avenues for data analytics and market insights. By leveraging technology integration in trading, developers can create innovative applications that enhance price discovery and provide digital asset solutions.
The Metals-API stands at the forefront of this transformation, offering developers the tools they need to access real-time and historical data on Gold and other metals. With its comprehensive API, developers can build next-generation applications that provide users with valuable insights into market trends and fluctuations.
API Description
The Metals-API is a powerful tool that allows developers to access real-time and historical exchange rates for various metals, including Gold (XAU). This API empowers developers to create applications that can analyze market trends, perform currency conversions, and track price fluctuations over time. By integrating the Metals-API, developers can harness the transformative potential of real-time metals data, enabling them to build applications that meet the demands of modern traders and investors.
For more information, visit the Metals-API Website or check out the Metals-API Documentation for detailed guidance on implementation.
Key Features and Endpoints
The Metals-API offers a variety of endpoints that provide different functionalities, allowing developers to tailor their applications to specific needs. Here are some of the key features:
- Latest Rates Endpoint: This endpoint provides real-time exchange rate data for Gold and other metals, updated based on your subscription plan. Developers can retrieve the latest rates every 60 minutes, 10 minutes, or even more frequently, depending on their needs.
- Historical Rates Endpoint: Access historical rates for Gold dating back to 2019. By appending a specific date to the API request, developers can obtain past exchange rates, which is essential for trend analysis and market research.
- Bid And Ask Endpoint: This feature allows developers to retrieve real-time bid and ask prices for Gold, providing insights into market liquidity and pricing dynamics.
- Convert Endpoint: The conversion endpoint enables developers to convert any amount from one currency to another, facilitating seamless transactions and calculations.
- Time-Series Endpoint: Developers can query the API for daily historical rates between two dates, which is useful for analyzing trends over specific periods.
- Fluctuation Endpoint: This endpoint provides information on how Gold prices fluctuate on a day-to-day basis, helping traders make informed decisions based on market volatility.
- Carat Endpoint: Retrieve information about Gold rates by Carat, allowing for precise calculations in jewelry and investment contexts.
- Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for Gold over a specified period, which is crucial for understanding market extremes.
- Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for Gold, essential for technical analysis and trading strategies.
- Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, which is vital for comprehensive market analysis.
For a complete list of supported symbols, refer to the Metals-API Supported Symbols page.
API Endpoint Examples and Responses
Latest Rates Endpoint
To retrieve real-time exchange rates for Gold and other metals, developers can use the Latest Rates Endpoint. Here’s a sample response:
{
"success": true,
"timestamp": 1784549263,
"base": "USD",
"date": "2026-07-20",
"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"
}
In this response, the "rates" object contains the exchange rates for various metals relative to USD, with Gold (XAU) priced at 0.000482 per troy ounce.
Historical Rates Endpoint
Accessing historical exchange rates is straightforward with the Historical Rates Endpoint. Here’s an example response:
{
"success": true,
"timestamp": 1784462863,
"base": "USD",
"date": "2026-07-19",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}
This response shows the exchange rates for Gold and other metals on a specific date, which is essential for historical analysis.
Time-Series Endpoint
The Time-Series Endpoint allows developers to retrieve exchange rates for a specific time period. Here’s a sample response:
{
"success": true,
"timeseries": true,
"start_date": "2026-07-13",
"end_date": "2026-07-20",
"base": "USD",
"rates": {
"2026-07-13": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-07-15": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-07-20": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}
This response provides daily rates for Gold over the specified period, allowing for trend analysis and forecasting.
Convert Endpoint
The Convert Endpoint is particularly useful for applications that require currency conversion. Here’s an example response:
{
"success": true,
"query": {
"from": "USD",
"to": "XAU",
"amount": 1000
},
"info": {
"timestamp": 1784549263,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}
This response indicates that converting 1000 USD results in 0.482 troy ounces of Gold, based on the current exchange rate.
Fluctuation Endpoint
Tracking rate fluctuations is essential for traders. Here’s a sample response from the Fluctuation Endpoint:
{
"success": true,
"fluctuation": true,
"start_date": "2026-07-13",
"end_date": "2026-07-20",
"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 response provides insights into how Gold prices have changed over the specified period, which is critical for making informed trading decisions.
OHLC (Open/High/Low/Close) Endpoint
For technical analysis, the OHLC Endpoint is invaluable. Here’s a sample response:
{
"success": true,
"timestamp": 1784549263,
"base": "USD",
"date": "2026-07-20",
"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 open, high, low, and close prices for Gold, which are essential for traders looking to analyze market movements.
Bid/Ask Endpoint
To understand market dynamics, the Bid/Ask Endpoint provides current bid and ask prices. Here’s an example response:
{
"success": true,
"timestamp": 1784549263,
"base": "USD",
"date": "2026-07-20",
"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 response shows the current bid and ask prices for Gold, along with the spread, which is crucial for traders to understand market liquidity.
Conclusion
Integrating the Metals-API into your applications provides a powerful way to access real-time and historical Gold exchange rates. By utilizing the various endpoints, developers can create applications that offer valuable insights into market trends, perform currency conversions, and track price fluctuations. Whether you are building a trading platform, a financial analysis tool, or a market research application, the Metals-API offers the flexibility and functionality needed to succeed in the precious metals market.
For further information on how to implement these features, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols for a comprehensive list of available metals. Embrace the future of precious metals trading by leveraging the power of real-time data with the Metals-API.