Access Kolhapur Gold 24k (KOLH-24k) Exchange Rates API Documentation in JSON Format

In today's rapidly evolving financial landscape, the demand for real-time data on precious metals, particularly gold, has surged. Developers seeking to integrate exchange rates for gold and other metals into their applications can leverage the powerful Metals-API. This API provides comprehensive access to exchange rates in JSON format, enabling seamless integration into various applications. In this blog post, we will explore how to retrieve exchange rates for gold (XAU) using the Metals-API, including sample API responses and integration tips.

About Gold (XAU)

Gold has long been considered a safe haven asset, especially during times of economic uncertainty. The digital transformation in precious metals trading has opened new avenues for investors and developers alike. By utilizing data analytics and market insights, developers can create applications that provide real-time updates on gold prices, allowing users to make informed decisions. The integration of technology in trading has revolutionized price discovery, making it easier than ever to access and analyze market data.

The Metals-API stands at the forefront of this transformation, offering developers the tools needed to build next-generation applications that harness the power of real-time metals data. With its user-friendly interface and comprehensive documentation, the Metals-API empowers developers to create innovative solutions that cater to the needs of modern investors.

API Description

The Metals-API is a robust JSON API that provides real-time and historical exchange rates for various metals, including gold (XAU), silver (XAG), platinum (XPT), and palladium (XPD). The API is designed to be flexible and scalable, making it suitable for a wide range of applications, from financial dashboards to trading platforms. Developers can access a variety of endpoints, each offering unique functionalities that enhance the user experience.

For more information, you can refer to the Metals-API Documentation, which provides detailed insights into the API's capabilities and usage.

Key Features and Endpoints

The Metals-API offers several key features that developers can leverage to build powerful applications:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for all available metals, updated every 60 minutes, 10 minutes, or even more frequently, depending on your subscription plan. This feature is crucial for applications that require up-to-the-minute pricing information.
Historical Rates Endpoint: Access historical exchange rates dating back to 2019. Developers can query the API for specific dates, allowing for in-depth analysis of price trends over time.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals. This feature is essential for trading applications that require accurate pricing information for executing trades.
Convert Endpoint: This endpoint allows developers to convert any amount from one metal to another or to/from USD. This functionality is particularly useful for applications that need to display prices in different currencies.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice. This feature enables developers to analyze price movements over specific periods.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis. This endpoint provides insights into market volatility and can help users make informed trading decisions.
Carat Endpoint: Retrieve information about gold rates by carat. This feature is particularly useful for jewelers and consumers looking to understand the value of gold in different purities.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specified date range. This information is vital for understanding market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Get the open, high, low, and close prices for a specific time period. This data is essential for technical analysis and trading strategies.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008. This endpoint is beneficial for users interested in long-term price trends.
API Key: Your unique API key is required to access the API. This key must be included in the API base URL's access_key parameter for authentication.
API Response: Exchange rates are delivered relative to USD by default. All data is returned in a structured JSON format, making it easy to parse and integrate into applications.
Available Endpoints: The Metals-API includes 14 different endpoints, each providing distinct functionalities to cater to various user needs.
Supported Symbols Endpoint: This endpoint returns all available currencies and metals, ensuring developers have access to the latest symbols.
Gold Price India Endpoint: Retrieve the latest gold price in India using this dedicated endpoint, which is particularly useful for regional applications.
News Endpoint: Stay updated with the latest news articles related to various metals, providing users with context around price movements.

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 the capabilities of the Metals-API, let's explore some example responses for various endpoints.

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
    "success": true,
    "timestamp": 1760342454,
    "base": "USD",
    "date": "2025-10-13",
    "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": 1760256054,
    "base": "USD",
    "date": "2025-10-12",
    "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-10-06",
    "end_date": "2025-10-13",
    "base": "USD",
    "rates": {
        "2025-10-06": {
            "XAU": 0.000485,
            "XAG": 0.03825,
            "XPT": 0.000915
        },
        "2025-10-08": {
            "XAU": 0.000483,
            "XAG": 0.0382,
            "XPT": 0.000913
        },
        "2025-10-13": {
            "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": 1760342454,
        "rate": 0.000482
    },
    "result": 0.482,
    "unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
    "success": true,
    "fluctuation": true,
    "start_date": "2025-10-06",
    "end_date": "2025-10-13",
    "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": 1760342454,
    "base": "USD",
    "date": "2025-10-13",
    "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": 1760342454,
    "base": "USD",
    "date": "2025-10-13",
    "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 provides a powerful and flexible solution for developers looking to access real-time and historical exchange rates for precious metals like gold (XAU). By leveraging the various endpoints available, developers can create innovative applications that cater to the needs of investors and traders alike. With features such as the Latest Rates, Historical Rates, and Bid/Ask endpoints, the API offers a comprehensive toolkit for integrating metals data into any application.

For further exploration of the API's capabilities, be sure to check out the Metals-API Documentation and the Metals-API Supported Symbols page. By utilizing these resources, developers can unlock the full potential of the Metals-API and create applications that provide valuable insights into the precious metals market.

Ready to use Metals-API?

Try it now!

Access Kolhapur Gold 24k (KOLH-24k) Exchange Rates API Documentation in JSON Format