Retrieve Chennai Gold 22k (CHEN-22k) Historical Prices using a Simple API

In today's digital age, the ability to access real-time and historical data is crucial for making informed decisions in the financial markets. For those interested in precious metals, particularly gold, the Metals-API offers a powerful solution for retrieving historical prices, including the Chennai Gold 22k (CHEN-22k). This blog post will explore the capabilities of the Metals-API, focusing on how developers can leverage its features to access historical gold prices and gain valuable market insights.

About Gold (XAU)

Gold, represented by the symbol XAU, has long been a symbol of wealth and a reliable store of value. In recent years, the digital transformation in the precious metals market has opened up new avenues for data analytics and market insights. The integration of technology in trading has revolutionized how investors approach gold trading, allowing for more innovative price discovery methods and digital asset solutions.

As the demand for gold continues to rise, understanding its historical price movements becomes essential for traders and investors. The Metals-API provides a comprehensive platform that empowers developers to build next-generation applications that can analyze gold price trends, track fluctuations, and make informed trading decisions.

API Description

The Metals-API is a robust JSON API that provides real-time and historical data on various metals, including gold, silver, platinum, and palladium. With its user-friendly interface and extensive documentation, developers can easily integrate the API into their applications to access a wealth of information.

One of the key advantages of the Metals-API is its ability to deliver real-time metals data, enabling developers to create applications that respond to market changes instantly. The API supports various endpoints that cater to different needs, from retrieving the latest rates to accessing historical data dating back to 2019.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that provide different functionalities, allowing developers to tailor their applications to specific requirements. Here are some of the most notable features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated every 60 minutes, 10 minutes, or even more frequently, depending on the subscription plan. This feature is essential for traders who need to stay updated on the latest market prices.
Historical Rates Endpoint: Developers can access historical rates for most currencies dating back to 2019. By appending a specific date to the API request, users can retrieve the historical price of gold, which is crucial for trend analysis.
Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices for metals, providing insights into market liquidity and pricing dynamics.
Convert Endpoint: The API includes a currency conversion endpoint, enabling users to convert amounts between different metals or to/from USD. This is particularly useful for traders dealing in multiple currencies.
Time-Series Endpoint: This endpoint allows users to query the API for daily historical rates between two selected dates, making it easy to analyze price movements over time.
Fluctuation Endpoint: Users can track how metal prices fluctuate on a day-to-day basis, providing insights into market volatility and trends.
Carat Endpoint: This feature allows users to retrieve gold rates by carat, which is particularly useful for jewelers and consumers looking for specific gold quality.
Lowest/Highest Price Endpoint: This endpoint enables users to query the API for the lowest and highest prices of gold over a specified period, assisting in identifying market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Users can access the open, high, low, and close prices for gold, which are essential for technical analysis.
Historical LME Endpoint: This endpoint provides access to historical rates for LME symbols dating back to 2008, allowing for comprehensive market analysis.
API Key: Each user is assigned a unique API key that must be included in API requests to authenticate access.
API Response: The API returns exchange rates relative to USD by default, ensuring consistency in data interpretation.
Available Endpoints: The Metals-API includes 14 different endpoints, each offering unique functionalities to cater to various user needs.
Supported Symbols Endpoint: This endpoint provides a constantly updated list of all available currencies and metals, ensuring users have access to the latest information.
News Endpoint: Users can retrieve the latest news articles related to various metals, keeping them informed about market 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. This resource is invaluable for developers looking to integrate specific metals into their applications.

API Endpoint Examples and Responses

Understanding how to interact with the Metals-API is crucial for developers. Below are examples of various API endpoints and their corresponding JSON responses, which illustrate the data structure and the information provided.

Latest Rates Endpoint

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

The response indicates that the request was successful and provides the latest exchange rates for various metals, including gold (XAU).

Historical Rates Endpoint

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

This example shows how to retrieve historical rates for gold and other metals for a specific date, allowing for detailed analysis of price trends.

Time-series Endpoint

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

The time-series endpoint allows users to analyze price movements over a specified period, providing a clear view of trends and fluctuations.

Convert Endpoint

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

This endpoint demonstrates how to convert a specified amount from USD to gold (XAU), providing the conversion rate and the resulting quantity in troy ounces.

Fluctuation Endpoint

{
    "success": true,
    "fluctuation": true,
    "start_date": "2025-10-31",
    "end_date": "2025-11-07",
    "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"
}

The fluctuation endpoint provides insights into how metal prices have changed over a specified period, highlighting both the absolute change and the percentage change.

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

{
    "success": true,
    "timestamp": 1762473849,
    "base": "USD",
    "date": "2025-11-07",
    "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 endpoint provides critical data for technical analysis, allowing traders to assess market performance over a specific time frame.

Bid/Ask Endpoint

{
    "success": true,
    "timestamp": 1762473849,
    "base": "USD",
    "date": "2025-11-07",
    "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 current bid and ask prices, which are essential for traders looking to execute orders at optimal prices.

Conclusion

The Metals-API is an invaluable tool for developers seeking to access historical prices and real-time data for precious metals, including gold. By leveraging its various endpoints, developers can create applications that provide insights into market trends, facilitate trading strategies, and enhance decision-making processes.

With features like the historical rates endpoint, time-series analysis, and real-time bid/ask data, the Metals-API empowers users to stay ahead in the dynamic world of precious metals trading. For more information on how to implement these features, refer to the Metals-API Documentation and explore the extensive capabilities of this powerful API.

As the market for precious metals continues to evolve, staying informed and utilizing advanced data analytics will be key to success. The Metals-API not only provides the necessary tools for this but also opens up new possibilities for innovation in trading and investment strategies.

Ready to use Metals-API?

Try it now!

Retrieve Chennai Gold 22k (CHEN-22k) Historical Prices using a Simple API