The Easiest Way to Get Kolkata Gold (XAU-KOLK) Historical Rates Using APIs

The Easiest Way to Get Kolkata Gold (XAU-KOLK) Historical Rates Using APIs

In today's digital age, accessing historical prices for precious metals like gold has become easier than ever, thanks to the advent of APIs. One of the most powerful tools available for developers is the Metals-API. This API provides comprehensive data on various metals, including gold (XAU), silver (XAG), platinum (XPT), and palladium (XPD). In this blog post, we will explore how to retrieve historical rates for Kolkata Gold (XAU-KOLK) using the Metals-API, including example endpoints, parameters, and data formats.

About Gold (XAU)

Gold has long been a symbol of wealth and a critical asset in the financial markets. With the rise of digital transformation in precious metals trading, the integration of data analytics and technology has revolutionized how investors and traders access market insights. The Metals-API stands at the forefront of this innovation, providing real-time data that empowers developers to build next-generation applications.

By leveraging the capabilities of the Metals-API, developers can create applications that not only track gold prices but also analyze market trends, forecast price movements, and facilitate trading strategies. The API's ability to deliver real-time data enhances price discovery and offers digital asset solutions that cater to the needs of modern investors.

API Description

The Metals-API is a robust JSON API that provides access to real-time and historical prices for various metals. It is designed to empower developers with the tools needed to create applications that require accurate and timely metal pricing data. The API supports a wide range of functionalities, including retrieving the latest rates, historical rates, bid and ask prices, and much more.

For detailed information on how to use the API, you can refer to the Metals-API Documentation. This documentation provides comprehensive guidance on the available endpoints, parameters, and response formats.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different data needs. Here are some of the key features:

• Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated based on your subscription plan. Depending on the plan, updates can occur every 60 minutes or every 10 minutes.
• Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to the endpoint. This feature is essential for analyzing past market trends.
• Bid and Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing traders to make informed decisions based on current market conditions.
• Convert Endpoint: This endpoint allows for currency conversion between different metals and USD, making it easy to calculate values in various contexts.
• Time-Series Endpoint: Query daily historical rates between two dates of your choice, enabling detailed analysis of price movements over time.
• Fluctuation Endpoint: Track how metal prices fluctuate on a day-to-day basis, providing insights into market volatility.
• Carat Endpoint: Retrieve gold rates by carat, which is particularly useful for jewelers and consumers interested in specific gold purity levels.
• Lowest/Highest Price Endpoint: Get the lowest and highest prices for a specified date, helping traders identify market extremes.
• Open/High/Low/Close (OHLC) Price Endpoint: Access OHLC data for a specific date, which is crucial for technical analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, useful for comprehensive market analysis.
• API Key: Your unique API key is required to access the API, ensuring secure and authorized usage.
• API Response: The API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format.
• Available Endpoints: The Metals-API features 14 different endpoints, each providing unique functionalities tailored to various user needs.
• Supported Symbols Endpoint: This endpoint returns a constantly updated list of all available metal symbols, ensuring you have access to the latest data.
• News Endpoint: Retrieve the latest news articles related to various metals, keeping you 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.

API Endpoint Examples and Responses

To illustrate how to use the Metals-API, let's explore some example endpoints and their corresponding JSON responses.

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1767845280,
"base": "USD",
"date": "2026-01-08",
"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": 1767758880,
"base": "USD",
"date": "2026-01-07",
"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-01-01",
"end_date": "2026-01-08",
"base": "USD",
"rates": {
"2026-01-01": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-01-03": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-01-08": {
"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": 1767845280,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-01-01",
"end_date": "2026-01-08",
"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": 1767845280,
"base": "USD",
"date": "2026-01-08",
"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": 1767845280,
"base": "USD",
"date": "2026-01-08",
"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

In conclusion, the Metals-API offers a powerful and flexible solution for accessing historical rates and real-time data for precious metals like gold. By utilizing the various endpoints available, developers can create sophisticated applications that provide valuable insights into market trends and trading opportunities. Whether you are looking to analyze historical data, track fluctuations, or convert between different metals, the Metals-API has you covered.

For more information on how to get started with the Metals-API, be sure to check out the Metals-API Documentation and explore the Metals-API Supported Symbols for a complete list of available metals. With the right tools and data at your fingertips, you can harness the power of real-time metals data to drive your trading strategies and investment decisions.