Query Patna Gold 24k (PATN-24k) Historical Prices using this API

Metals-API offers a robust solution. This blog post will delve into the capabilities of the Metals-API, focusing on how to retrieve historical prices and other valuable data related to gold.

About Gold (XAU)

API Description

Metals-API Documentation. This resource provides comprehensive guidance on the API's features, endpoints, and usage examples.

Key Features and Endpoints

Latest Rates Endpoint: Depending on your subscription plan, this endpoint returns real-time exchange rate data updated every 60 minutes or even more frequently. This 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 your query, you can retrieve the price of gold (XAU) for any given day.
Bid And Ask Endpoint: This powerful feature allows you to retrieve real-time bid and ask prices, providing insight into market liquidity and pricing dynamics.
Convert Endpoint: This endpoint enables you to convert any amount from one metal to another or to/from USD, making it easier to understand the value of gold in different contexts.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, allowing for trend analysis over time.
Fluctuation Endpoint: Retrieve information about how gold prices fluctuate on a day-to-day basis, which is crucial for understanding market volatility.
Carat Endpoint: Get information about gold rates by carat, which is particularly useful for jewelers and consumers interested in specific gold purities.
Lowest/Highest Price Endpoint: This endpoint allows you to query the API to get the lowest and highest price of gold for a specified date.
Open/High/Low/Close (OHLC) Price Endpoint: Retrieve the open, high, low, and close prices for gold, which are essential for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a broader context for price movements.
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 provides a constantly updated list of all available currencies and metals.
Gold Price India Endpoint: Retrieve the latest gold price in India using this dedicated endpoint, which is particularly useful for local traders.
News Endpoint: Stay updated with the latest news articles related to various metals, providing context to market movements.

List of Symbols

Metals-API Supported Symbols page.

API Endpoint Examples and Responses

Latest Rates Endpoint

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

timestamp field provides the time of the request, while the base field indicates the currency used for the exchange rates. The rates object contains the current prices for various metals, including gold (XAU), expressed in troy ounces.

Historical Rates Endpoint

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

date field indicates the day for which the rates are provided, and the rates object lists the prices for gold and other metals.

Time-series Endpoint

{
    "success": true,
    "timeseries": true,
    "start_date": "2025-06-01",
    "end_date": "2025-06-08",
    "base": "USD",
    "rates": {
        "2025-06-01": {
            "XAU": 0.000485,
            "XAG": 0.03825,
            "XPT": 0.000915
        },
        "2025-06-03": {
            "XAU": 0.000483,
            "XAG": 0.0382,
            "XPT": 0.000913
        },
        "2025-06-08": {
            "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": 1749348241,
        "rate": 0.000482
    },
    "result": 0.482,
    "unit": "troy ounces"
}

query object shows the conversion parameters, while the result field provides the converted value in troy ounces.

Fluctuation Endpoint

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

change and change_pct fields indicate the absolute and percentage changes in price, respectively.

OHLC (Open/High/Low/Close) Endpoint

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

open, high, low, and close prices are essential for technical analysis and decision-making.

Bid/Ask Endpoint

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

spread field indicates the difference between the bid and ask prices, which is crucial for understanding market liquidity.

Conclusion

Metals-API Website and explore the Metals-API Documentation for detailed guidance on implementation. Additionally, check out the Metals-API Supported Symbols page to familiarize yourself with the various metals available through the API.

Ready to use Metals-API?

Try it now!

Query Patna Gold 24k (PATN-24k) Historical Prices using this API