Get Jaipur Gold 22k (JAIP-22k) prices using this API

Metals-API provides a robust solution for retrieving the latest gold prices and other metal rates, empowering users to integrate this data into their applications seamlessly.

Understanding Gold (XAU) and Its Market Dynamics

The Role of Data Analytics in Precious Metals

Technology Integration in Trading

API Overview: Metals-API Capabilities

Key Features of Metals-API

• Latest Rates Endpoint: Depending on your subscription plan, this endpoint returns real-time exchange rate data updated every 60 minutes or more frequently. This is crucial for traders who need the latest information to make timely decisions.
• Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. This feature allows users to analyze past trends and make informed predictions about future price movements.
• Bid and Ask Endpoint: Retrieve real-time bid and ask prices, which are essential for understanding market liquidity and making trading decisions.
• Convert Endpoint: This endpoint allows users to convert any amount from one currency to another, facilitating easy transactions across different metals.
• Time-Series Endpoint: Query the API for daily historical rates between two dates, providing insights into price trends over time.
• Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, which is vital for understanding market volatility.
• Carat Endpoint: Retrieve information about gold rates by carat, allowing users to get precise pricing for different gold purities.
• Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specified date, which can help traders identify market extremes.
• Open/High/Low/Close (OHLC) Price Endpoint: Get the open, high, low, and close prices for a specific time period, which is essential for technical analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a long-term view of metal prices.
• API Key: Each user is assigned a unique API key that must be included in requests to authenticate access to the API.
• API Response: Exchange rates are delivered relative to USD by default, ensuring consistency in data interpretation.
• Available Endpoints: The API offers a variety of endpoints, each providing different functionalities to cater to diverse user needs.
• Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals supported by the API.
• Gold Price India Endpoint: Retrieve the latest gold price in India, which is particularly useful for traders in that market.
• News Endpoint: Get the latest news articles related to various metals, keeping users informed about market developments.

Detailed API Endpoint Documentation

Latest Rates Endpoint

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

rates object contains the current price of various metals, including gold (XAU). The unit indicates that the prices are quoted per troy ounce.

Historical Rates Endpoint

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

rates object provides historical prices for gold and other metals, allowing traders to assess past performance and make predictions.

Time-Series Endpoint

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

result field indicates the converted amount in troy ounces, providing a straightforward way to understand value across different metals.

Fluctuation Endpoint

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

Open/High/Low/Close (OHLC) Price Endpoint

{
    "success": true,
    "timestamp": 1744344017,
    "base": "USD",
    "date": "2025-04-11",
    "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": 1744344017,
    "base": "USD",
    "date": "2025-04-11",
    "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 indicates the difference between the bid and ask prices, which is crucial for traders looking to execute trades efficiently.

Common Developer Questions and Troubleshooting

How do I authenticate my API requests?

What should I do if I receive an error response?

Metals-API Documentation for detailed error handling guidelines.

How can I optimize my API usage?

Conclusion

Metals-API Website and explore the Metals-API Supported Symbols for a comprehensive list of available metals and currencies.