How to Retrieve GURG-22k Historical Prices with Metals-API

How to Retrieve GURG-22k Historical Prices with Metals-API

Metals-API Information

About Gurgaon Gold 22k (GURG-22k)

API Description

Metals-API Documentation, which provides comprehensive guidance on the various endpoints and their functionalities.

Key Features and Endpoints

• Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated every 60 minutes or more frequently based on the subscription plan. It allows developers to access the most current pricing information for GURG-22k and other metals.
• Historical Rates Endpoint: Developers can retrieve historical rates dating back to 2019 by appending a specific date to the API request. This feature is essential for analyzing trends and making informed decisions based on past performance.
• Bid and Ask Endpoint: This powerful feature enables users to retrieve real-time bid and ask prices for metals, providing insights into market liquidity and pricing dynamics.
• Convert Endpoint: The Metals-API includes a currency conversion feature that allows users to convert amounts between different metals or to/from USD, facilitating easier transactions and comparisons.
• Time-Series Endpoint: This endpoint allows developers to query the API for daily historical rates between two specified dates, making it easier to analyze price movements over time.
• Fluctuation Endpoint: Users can track how metal prices fluctuate on a day-to-day basis, providing valuable insights into market volatility.
• Carat Endpoint: This feature allows users to retrieve gold rates by carat, which is particularly useful for jewelers and consumers looking for specific quality metrics.
• Lowest/Highest Price Endpoint: Developers can query the API to get the lowest and highest prices for a specified date, which is crucial for understanding market extremes.
• Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific date, allowing for detailed market analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, which is essential for comprehensive market analysis.
• API Key: Each user is assigned a unique API key that must be included in requests to authenticate and authorize access to the API.
• 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 multiple endpoints, each designed to provide specific functionalities tailored to user needs.
• Supported Symbols Endpoint: This endpoint returns a constantly updated list of all available currencies and metals, ensuring developers have access to the latest information.
• Gold Price India Endpoint: Retrieve the latest gold price in India using this dedicated endpoint, which is particularly useful for local traders.
• News Endpoint: Access the latest news articles related to various metals, keeping users informed about market developments.

Metals-API Supported Symbols page.

API Endpoint Examples and Responses

Latest Rates Endpoint

{
    "success": true,
    "timestamp": 1742533214,
    "base": "USD",
    "date": "2025-03-21",
    "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": 1742446814,
    "base": "USD",
    "date": "2025-03-20",
    "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-03-14",
    "end_date": "2025-03-21",
    "base": "USD",
    "rates": {
        "2025-03-14": {
            "XAU": 0.000485,
            "XAG": 0.03825,
            "XPT": 0.000915
        },
        "2025-03-16": {
            "XAU": 0.000483,
            "XAG": 0.0382,
            "XPT": 0.000913
        },
        "2025-03-21": {
            "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": 1742533214,
        "rate": 0.000482
    },
    "result": 0.482,
    "unit": "troy ounces"
}

Fluctuation Endpoint

{
    "success": true,
    "fluctuation": true,
    "start_date": "2025-03-14",
    "end_date": "2025-03-21",
    "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": 1742533214,
    "base": "USD",
    "date": "2025-03-21",
    "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": 1742533214,
    "base": "USD",
    "date": "2025-03-21",
    "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 and explore the comprehensive Metals-API Documentation for detailed guidance on implementation and usage.