Fetch Gold (NYM $/ozt) Front Month (GC1) prices with this API

Introduction

In the ever-evolving landscape of financial markets, the ability to access real-time data is crucial for traders and developers alike. One such valuable resource is the Metals-API, which provides comprehensive data on precious metals, including the widely traded Gold (XAU). This blog post will delve into the functionalities of the Metals-API, exploring its capabilities, endpoints, and how it can empower developers to create innovative applications in the realm of precious metals trading.

Metals-API Information

About Gold (XAU)

Gold has long been a symbol of wealth and stability, serving as a hedge against inflation and economic uncertainty. With the digital transformation of financial markets, the integration of data analytics and technology in trading has become paramount. The Metals-API facilitates this transformation by offering real-time insights into gold prices, enabling traders to make informed decisions based on accurate data.

As the market for precious metals continues to evolve, the demand for innovative price discovery methods and digital asset solutions has surged. The Metals-API stands at the forefront of this evolution, providing developers with the tools necessary to harness the power of real-time metals data. By leveraging this API, developers can create applications that not only track gold prices but also analyze market trends and fluctuations, ultimately enhancing trading strategies.

API Description

The Metals-API is designed to provide developers with a robust platform for accessing real-time and historical data on various metals, including gold, silver, platinum, and palladium. With its user-friendly interface and comprehensive documentation, the API empowers developers to build next-generation applications that can analyze and visualize precious metals data.

For more detailed information, you can visit the Metals-API Documentation. This resource provides extensive guidance on how to effectively utilize the API's features and endpoints.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs, each providing unique functionalities that can be leveraged for various applications:

• Latest Rates Endpoint: This endpoint provides real-time exchange rate data for precious metals, updated based on your subscription plan. Depending on the plan, data can be refreshed every 60 minutes or every 10 minutes, ensuring that traders have access to the most current information.
• Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your query. This feature is invaluable for analyzing past market trends and making informed predictions about future movements.
• Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing traders to gauge market sentiment and make timely decisions.
• Convert Endpoint: This endpoint allows users to convert any amount from one metal to another or to/from USD, facilitating seamless transactions across different currencies.
• Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, enabling detailed analysis of price movements over time.
• Fluctuation Endpoint: Track how prices fluctuate on a day-to-day basis, providing insights into market volatility and trends.
• Carat Endpoint: Retrieve information about gold rates by carat, which is essential for jewelers and traders dealing in various purities of gold.
• Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date, aiding in market analysis and decision-making.
• Open/High/Low/Close (OHLC) Price Endpoint: Access open, high, low, and close prices for a specific period, which is crucial for technical analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a long-term view of market trends.
• API Key: Your unique API key is required for authentication and must be included in the API base URL's access_key parameter to access the data.
• 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 includes 14 endpoints, each offering distinct functionalities to cater to various user needs.
• Supported Symbols Endpoint: This endpoint provides 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 traders 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.

API Endpoint Examples and Responses

Understanding the API's response structure is crucial for effective integration. Below are examples of various endpoints and their corresponding JSON responses:

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
    "success": true,
    "timestamp": 1763856074,
    "base": "USD",
    "date": "2025-11-23",
    "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": 1763769674,
    "base": "USD",
    "date": "2025-11-22",
    "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-11-16",
    "end_date": "2025-11-23",
    "base": "USD",
    "rates": {
        "2025-11-16": {
            "XAU": 0.000485,
            "XAG": 0.03825,
            "XPT": 0.000915
        },
        "2025-11-18": {
            "XAU": 0.000483,
            "XAG": 0.0382,
            "XPT": 0.000913
        },
        "2025-11-23": {
            "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": 1763856074,
        "rate": 0.000482
    },
    "result": 0.482,
    "unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

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

Get OHLC data for a specific time period:

{
    "success": true,
    "timestamp": 1763856074,
    "base": "USD",
    "date": "2025-11-23",
    "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": 1763856074,
    "base": "USD",
    "date": "2025-11-23",
    "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 is a powerful tool for developers looking to integrate real-time and historical data on precious metals into their applications. With its extensive range of endpoints, including the latest rates, historical data, and conversion capabilities, the API provides a comprehensive solution for traders and analysts alike. By leveraging the capabilities of the Metals-API, developers can create innovative applications that enhance trading strategies, improve market analysis, and facilitate seamless transactions.

For further exploration of the API's features, visit the Metals-API Website and check out the Metals-API Documentation for detailed implementation guidance. Additionally, for a complete list of supported symbols, refer to the Metals-API Supported Symbols page. Embrace the future of trading with the Metals-API and unlock the potential of real-time metals data.