Step-by-step guide to get Madurai Gold 24k (MADU-24k) prices using this API

Step-by-step guide to get Madurai Gold 24k (MADU-24k) prices using the Metals-API

Gold, particularly in the form of 24k, is a highly sought-after asset in the financial markets. With the rise of digital transformation in precious metals trading, developers and traders alike are increasingly turning to APIs for real-time data and insights. The Metals-API provides a robust solution for accessing gold prices, including Madurai Gold 24k (MADU-24k), and other precious metals. This guide will walk you through the process of retrieving gold prices using the Metals-API, while also exploring the innovative features and capabilities that this API offers.

About Gold (XAU)

Gold, represented by the symbol XAU, is not just a commodity; it is a digital asset that has undergone significant transformation due to advancements in technology. The integration of data analytics and market insights has revolutionized how traders and investors approach gold trading. With the Metals-API, developers can leverage real-time data to build next-generation applications that facilitate innovation in price discovery and trading strategies.

API Description

The Metals-API is designed to empower developers by providing access to real-time and historical data for various metals, including gold. This API allows for seamless integration into applications, enabling users to retrieve exchange rates, historical data, and much more. The transformative potential of real-time metals data cannot be overstated, as it allows for informed decision-making and strategic trading.

For more information, you can refer to the Metals-API Documentation, which provides comprehensive details on how to utilize the API effectively.

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 metals, updated based on your subscription plan. This feature is crucial for traders who need up-to-the-minute information to make informed decisions.

Historical Rates Endpoint

Access to historical rates dating back to 2019 allows users to analyze trends and make predictions based on past performance. By appending a date in the format YYYY-MM-DD, developers can query historical data effectively.

Bid and Ask Endpoint

This powerful feature enables users to retrieve real-time bid and ask prices, which are essential for understanding market dynamics and making trading decisions.

Convert Endpoint

The Convert Endpoint allows for seamless currency conversion, enabling users to convert any amount from one metal to another or to/from USD. This is particularly useful for traders operating in multiple currencies.

Time-Series Endpoint

With the Time-Series Endpoint, users can query daily historical rates between two dates of their choice, providing a comprehensive view of price movements over time.

Fluctuation Endpoint

This endpoint provides insights into how currencies fluctuate on a day-to-day basis, helping traders understand volatility and market trends.

Carat Endpoint

For those interested in gold rates by carat, this endpoint allows users to retrieve specific information by appending a base to the request.

Lowest/Highest Price Endpoint

Users can query the API to get the lowest and highest prices for a specified date, which is vital for understanding market extremes.

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

This endpoint provides open, high, low, and close prices for a specific time period, allowing traders to analyze market behavior effectively.

Historical LME Endpoint

Access historical rates for LME symbols dating back to 2008, which is essential for traders focusing on industrial metals.

API Key and Response

Your API Key is essential for accessing the Metals-API. It is passed into the API base URL's access_key parameter. The API responses are delivered in JSON format, with exchange rates typically relative to USD.

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": 1775779939,
"base": "USD",
"date": "2026-04-10",
"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": 1775693539,
"base": "USD",
"date": "2026-04-09",
"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-04-03",
"end_date": "2026-04-10",
"base": "USD",
"rates": {
"2026-04-03": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-04-05": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-04-10": {
"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": 1775779939,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-04-03",
"end_date": "2026-04-10",
"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) Price Endpoint

Get OHLC data for a specific time period:

{
"success": true,
"timestamp": 1775779939,
"base": "USD",
"date": "2026-04-10",
"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": 1775779939,
"base": "USD",
"date": "2026-04-10",
"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 is an invaluable resource for developers and traders looking to access real-time and historical data for gold and other precious metals. By leveraging its various endpoints, users can gain insights into market trends, perform currency conversions, and track fluctuations effectively. The API's comprehensive documentation and support for a wide range of symbols make it a powerful tool for anyone involved in the metals market.

For further exploration, consider visiting the Metals-API Documentation for detailed guidance on implementation, or check out the Metals-API Supported Symbols page to familiarize yourself with the available options. The Metals-API Website is also a great starting point for understanding the full capabilities of this API.