How to retrieve Coimbatore Gold 18k (COIM-18k) prices with an API

Introduction

In the world of precious metals trading, staying updated with real-time prices is crucial for investors and traders alike. One of the most sought-after metals is gold, specifically the 18k variant, often referred to by its symbol COIM-18k. To efficiently retrieve the latest prices and historical data for gold and other metals, developers can leverage the Metals-API. This powerful API provides comprehensive access to real-time and historical data, enabling the creation of innovative applications that can transform how we interact with precious metals markets.

Metals-API Information

About Gold (XAU)

Gold, represented by the symbol XAU, is not just a valuable asset; it is a cornerstone of the global financial system. The digital transformation in precious metals trading has led to the integration of advanced data analytics and technology, allowing traders to gain market insights that were previously unattainable. With the rise of digital asset solutions, the demand for accurate and timely gold pricing data has surged.

In this context, the Metals-API stands out as a transformative tool. It empowers developers to build next-generation applications that can provide real-time price discovery, enabling users to make informed trading decisions. By utilizing data analytics, traders can analyze market trends, assess price fluctuations, and optimize their trading strategies.

API Description

The Metals-API is designed to provide developers with a robust framework for accessing real-time metals data. With its innovative capabilities, the API allows users to retrieve the latest rates, historical data, and even perform currency conversions. The API's architecture is built to support a wide range of applications, from simple price retrieval to complex trading algorithms.

For detailed information on how to implement the API, developers can refer to the Metals-API Documentation. This resource provides comprehensive guidance on using the API effectively, including endpoint descriptions, parameter specifications, and response formats.

Key Features and Endpoints

The Metals-API offers a variety of endpoints, each designed to fulfill specific needs in the realm of metals trading. Here are some of the key 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 your subscription plan. This feature is essential for traders who need the most current pricing information.
• Historical Rates Endpoint: Access historical rates dating back to 2019. By appending a specific date to the API request, users can retrieve past pricing data, which is invaluable for trend analysis and market research.
• Bid And Ask Endpoint: This feature allows users to obtain real-time bid and ask prices for various metals, providing insights into market liquidity and pricing dynamics.
• Convert Endpoint: The API includes a currency conversion feature, 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: Users can query the API for daily historical rates between two specified dates, facilitating in-depth analysis of price movements over time.
• Fluctuation Endpoint: Track how metal prices fluctuate on a day-to-day basis. This endpoint provides valuable insights into market volatility and helps traders make informed decisions.
• Carat Endpoint: Retrieve gold rates by carat, allowing users to understand the value of gold based on its purity.
• Lowest/Highest Price Endpoint: Query the API to find the lowest and highest prices for a specified date, aiding in market analysis.
• Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific date, essential for technical analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, which is crucial for users interested in long-term market trends.
• API Key: The API requires an access key for authentication, ensuring secure access to the data.
• API Response: All exchange rates are delivered relative to USD by default, with data returned in a structured JSON format.
• Available Endpoints: The API features 14 endpoints, each providing unique functionalities tailored to various user needs.
• Supported Symbols Endpoint: This endpoint returns a constantly updated list of all available currencies and metals, ensuring users have access to the latest information.
• News Endpoint: Retrieve the latest news articles related to various metals, keeping users 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 the structure of API responses is crucial for effective integration. Below are examples of various API endpoints, showcasing their functionality and response formats.

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

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

This response indicates that the API successfully retrieved the latest rates for various metals, with values expressed per troy ounce.

Historical Rates Endpoint

Access historical exchange rates for any date since 1999:

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

This response provides historical rates, allowing users to analyze past market behavior.

Time-series Endpoint

Get exchange rates for a specific time period:

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

This endpoint allows users to track price changes over a specified period, providing valuable insights into market trends.

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": 1765346530,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

This response demonstrates the conversion of USD to gold, providing the result in troy ounces.

Fluctuation Endpoint

Track rate fluctuations between two dates:

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

This endpoint provides insights into how prices have changed over time, which is essential for traders looking to capitalize on market movements.

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period:

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

This response provides critical data for traders who rely on technical analysis to make informed decisions.

Bid/Ask Endpoint

Get current bid and ask prices for metals:

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

This endpoint is vital for understanding market dynamics, as it provides the current bid and ask prices, along with the spread.

Conclusion

The Metals-API is a powerful tool for developers looking to integrate real-time and historical data for precious metals like gold into their applications. By leveraging its extensive features, including the latest rates, historical data, and various conversion options, developers can create innovative solutions that enhance trading strategies and market analysis.

As the digital transformation in precious metals continues to evolve, the importance of accurate and timely data cannot be overstated. The Metals-API not only provides the necessary data but also empowers developers to build applications that can adapt to changing market conditions.

For those interested in diving deeper into the capabilities of the Metals-API, I encourage you to explore the Metals-API Documentation and familiarize yourself with the various endpoints and their functionalities. Additionally, the Metals-API Supported Symbols page offers a comprehensive list of available metals, ensuring you have all the information you need at your fingertips.

In conclusion, whether you are a trader, developer, or simply interested in the precious metals market, the Metals-API provides the tools necessary to navigate this complex landscape effectively.