Retrieve Kolkata Gold (XAU-KOLK) Historical Prices with this API

Metals-API provides a robust solution for retrieving historical prices, enabling users to make informed decisions based on comprehensive data analytics and market insights. This blog post will delve into the capabilities of the Metals-API, focusing on how to effectively retrieve historical prices for Gold in Kolkata, India, and explore the broader implications of digital transformation in the precious metals market.

About Gold (XAU)

API Description

Metals-API Documentation, which provides comprehensive guidance on endpoint usage, response formats, and best practices.

Key Features and Endpoints

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for Gold and other metals. Depending on your subscription plan, the API updates this data every 60 minutes, every 10 minutes, or even more frequently. This feature is essential for traders who need up-to-the-minute information to make quick decisions.
Historical Rates Endpoint: Users can access historical rates for Gold dating back to 2019. By appending a specific date to the API request, developers can retrieve historical price data, which is crucial for trend analysis and market forecasting.
Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time Bid and Ask prices for Gold and other metals. Understanding the spread between these prices is vital for traders looking to optimize their entry and exit points.
Convert Endpoint: The Metals-API includes a currency conversion endpoint, enabling users to convert amounts from one metal to another or to/from USD. This feature is particularly useful for traders operating in multiple currencies.
Time-Series Endpoint: This endpoint allows users to query the API for daily historical rates between two specified dates. It is ideal for analyzing price movements over a specific period, providing insights into market trends.
Fluctuation Endpoint: Users can track how Gold prices fluctuate on a day-to-day basis using this endpoint. It provides valuable information about market volatility, helping traders assess risk.
Carat Endpoint: This feature allows users to retrieve Gold rates by Carat, which is essential for jewelers and consumers interested in purchasing Gold jewelry.
Lowest/Highest Price Endpoint: This endpoint enables users to query the API for the lowest and highest prices of Gold over a specified period, offering insights into market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Users can access OHLC data for Gold, which is crucial for technical analysis and understanding market behavior.
Historical LME Endpoint: This endpoint provides access to historical rates for LME symbols, dating back to 2008, allowing for comprehensive analysis of market trends.
API Key: To access the Metals-API, users must obtain an API Key, which is passed into the API base URL's access_key parameter. This key is essential for authentication and authorization.
API Response: The API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format, making it easy for developers to integrate into their applications.
Available Endpoints: The Metals-API provides a constantly updated list of all available currencies and metals, ensuring users have access to the latest information.
Gold Price India Endpoint: This dedicated endpoint allows users to retrieve the latest Gold price in India, making it particularly useful for local traders and investors.
News Endpoint: The Metals-API also includes a news endpoint that retrieves the latest articles related to various metals, keeping users informed about market developments.

List of Symbols

Metals-API Supported Symbols page. This resource is invaluable for developers looking to understand the full scope of metals available through the API.

API Endpoint Examples and Responses

Latest Rates Endpoint

{
    "success": true,
    "timestamp": 1749571215,
    "base": "USD",
    "date": "2025-06-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

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

Time-series Endpoint

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

Convert Endpoint

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

Fluctuation Endpoint

{
    "success": true,
    "fluctuation": true,
    "start_date": "2025-06-03",
    "end_date": "2025-06-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) Endpoint

{
    "success": true,
    "timestamp": 1749571215,
    "base": "USD",
    "date": "2025-06-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

{
    "success": true,
    "timestamp": 1749571215,
    "base": "USD",
    "date": "2025-06-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

Metals-API Website for more information and to access the Metals-API Documentation for detailed guidance on implementation. Understanding the various endpoints and their functionalities will empower you to harness the power of real-time metals data effectively.

Ready to use Metals-API?

Try it now!

Retrieve Kolkata Gold (XAU-KOLK) Historical Prices with this API