How to retrieve Madurai Gold 22k (MADU-22k) prices via API

Introduction

In the ever-evolving landscape of precious metals trading, the ability to retrieve real-time data is crucial for developers and traders alike. One such valuable asset is Madurai Gold 22k (MADU-22k), a popular choice among investors. This blog post will delve into how to effectively retrieve Madurai Gold prices via the Metals-API, exploring its capabilities, features, and the transformative potential it holds for developers in the precious metals market.

Metals-API Information

About Gold (XAU)

Gold, represented by the symbol XAU, has long been a cornerstone of wealth and investment. As digital transformation sweeps across industries, the precious metals market is no exception. The integration of data analytics and technology in trading has revolutionized how investors access market insights. With the advent of APIs like Metals-API, developers can harness real-time data to innovate price discovery and create digital asset solutions that cater to modern trading needs.

API Description

The Metals-API is a powerful tool designed to provide developers with real-time and historical data on various metals, including gold, silver, platinum, and palladium. This API empowers developers to build next-generation applications that can analyze market trends, track price fluctuations, and make informed trading decisions. By leveraging the capabilities of Metals-API, developers can create applications that not only retrieve data but also provide insights into market dynamics.

Key Features and Endpoints

The Metals-API offers a range of endpoints that cater to different needs within the precious metals market. Each endpoint is designed to provide specific functionalities that can be integrated into applications seamlessly. Here are some of the key features:

Latest Rates Endpoint: Depending on your subscription plan, this endpoint returns real-time exchange rate data for metals, updated every 60 minutes or more frequently. This feature is essential for traders who need the most current prices to make timely decisions.
Historical Rates Endpoint: Access historical rates dating back to 2019. By appending a specific date, developers can query the API for past rates, allowing for comprehensive market analysis and trend identification.
Bid And Ask Endpoint: This powerful feature retrieves real-time bid and ask prices for metals, providing traders with critical information for executing trades effectively.
Convert Endpoint: This endpoint allows users to convert any amount from one metal to another or to/from USD, facilitating easy calculations for traders dealing in multiple currencies.
Time-Series Endpoint: Developers can query the API for daily historical rates between two dates, enabling them to analyze trends over specific periods.
Fluctuation Endpoint: This endpoint provides insights into how metal prices fluctuate on a day-to-day basis, helping traders understand market volatility.
Carat Endpoint: Retrieve information about gold rates by carat, which is particularly useful for jewelers and consumers looking to understand the value of gold jewelry.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date, aiding in market analysis and decision-making.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides the 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, which is invaluable for long-term market analysis.
API Key: The unique key required for authentication, ensuring secure access to the API.
API Response: Exchange rates are delivered relative to USD, with all data returned in a structured JSON format.
Available Endpoints: The API comes with multiple endpoints, each providing different functionalities tailored to various user needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies and metals, allowing developers to stay informed about the latest offerings.
Gold Price India Endpoint: Retrieve the latest gold price in India, which is particularly useful for traders operating in the Indian market.
News Endpoint: Access the latest news articles related to various metals, keeping users informed about market trends and developments.

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

Understanding the API responses is crucial for effective integration. Below are examples of various endpoints and their corresponding JSON responses:

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

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

Historical Rates Endpoint

Access historical exchange rates for any date since 1999:

{
    "success": true,
    "timestamp": 1743559222,
    "base": "USD",
    "date": "2025-04-02",
    "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": "2025-03-27",
    "end_date": "2025-04-03",
    "base": "USD",
    "rates": {
        "2025-03-27": {
            "XAU": 0.000485,
            "XAG": 0.03825,
            "XPT": 0.000915
        },
        "2025-03-29": {
            "XAU": 0.000483,
            "XAG": 0.0382,
            "XPT": 0.000913
        },
        "2025-04-03": {
            "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": 1743645622,
        "rate": 0.000482
    },
    "result": 0.482,
    "unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

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

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period:

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

Bid/Ask Endpoint

Get current bid and ask prices for metals:

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

Conclusion

The Metals-API is a transformative tool for developers looking to access real-time and historical data on precious metals, including Madurai Gold 22k (MADU-22k). By utilizing its various endpoints, developers can create applications that not only retrieve data but also provide valuable insights into market trends and price fluctuations. The integration of technology in trading is paving the way for innovative solutions that enhance the trading experience.

For more information on how to implement these features and to explore the full capabilities of the Metals-API, visit the Metals-API Documentation. To stay updated on the latest symbols and offerings, check the Metals-API Supported Symbols page. For general inquiries and access to the API, visit the Metals-API Website.

Ready to use Metals-API?

Try it now!

Documentation

API Endpoints

Knowledge Base