Access SPDR Gold Shares (GLD) Exchange Rate API Documentation in JSON Format

In today's rapidly evolving financial landscape, the ability to access real-time data is paramount for developers and traders alike. The Metals-API offers a robust solution for retrieving SPDR Gold Shares (GLD) exchange rates in JSON format, enabling developers to integrate precious metals data into their applications seamlessly. This blog post will delve into the capabilities of the Metals-API, exploring its features, endpoints, and practical applications while providing sample API responses to illustrate its functionality.

About Gold (XAU)

Gold, represented by the symbol XAU, has long been a cornerstone of financial markets, serving as a safe haven during economic uncertainty. As digital transformation reshapes the landscape of precious metals trading, the integration of data analytics and technology becomes increasingly vital. The Metals-API stands at the forefront of this transformation, offering developers the tools to harness real-time market insights and innovate in price discovery.

With the rise of digital asset solutions, the Metals-API empowers developers to create next-generation applications that leverage the power of real-time metals data. By providing access to comprehensive market information, the API enables users to make informed decisions, optimize trading strategies, and enhance their overall trading experience.

API Description

The Metals-API is designed to provide developers with a powerful and flexible interface for accessing real-time and historical metals data. With a focus on innovation and technological advancement, the API allows users to retrieve exchange rates, historical data, and various other functionalities that can be integrated into trading platforms, financial applications, and analytical tools.

For more information, you can visit the Metals-API Documentation, which provides comprehensive details on how to utilize the API effectively. Additionally, the Metals-API Supported Symbols page offers a complete list of all available metal symbols, ensuring that developers have access to the data they need.

Key Features and Endpoints

The Metals-API boasts a wide array of features and endpoints, each designed to cater to different needs and use cases. Below, we explore some of the most significant endpoints and their potential applications:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for various metals, updated at intervals depending on your subscription plan. For instance, users can receive updates every 60 minutes or every 10 minutes, ensuring they have the most current information at their fingertips.
Historical Rates Endpoint: Access historical exchange rates dating back to 2019 by appending a specific date (YYYY-MM-DD) to the endpoint. This feature is invaluable for developers looking to analyze trends and make data-driven decisions based on past performance.
Bid And Ask Endpoint: This powerful feature allows 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 dedicated currency conversion endpoint, enabling users to convert amounts between different metals or to/from USD. This functionality is essential for traders who operate across multiple currencies.
Time-Series Endpoint: Users can query the API for daily historical rates between two specified dates, allowing for in-depth analysis of price movements over time.
Fluctuation Endpoint: This endpoint provides information on how currencies fluctuate on a day-to-day basis, helping traders understand market volatility and make informed decisions.
Carat Endpoint: Retrieve information about gold rates by carat, which is particularly useful for jewelers and those in the luxury goods market.
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: This endpoint provides open, high, low, and close prices for a specific date, offering a comprehensive view of market performance.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, allowing for extensive historical analysis.
API Key: Each user is assigned a unique API key, which must be included in the API requests to authenticate access.
API Response: The Metals-API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format.
Available Endpoints: The API features 14 distinct endpoints, each offering unique functionalities tailored to various user needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, ensuring users have access to the latest data.
Intraday Endpoint: Query intraday exchange rate data for a single symbol, providing insights into short-term market 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 Symbols page. This resource is essential for developers looking to integrate specific metals into their applications.

API Endpoint Examples and Responses

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1786306036,
"base": "USD",
"date": "2026-08-09",
"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": 1786219636,
"base": "USD",
"date": "2026-08-08",
"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": "2026-08-02",
"end_date": "2026-08-09",
"base": "USD",
"rates": {
"2026-08-02": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-08-04": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-08-09": {
"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": 1786306036,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-08-02",
"end_date": "2026-08-09",
"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": 1786306036,
"base": "USD",
"date": "2026-08-09",
"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": 1786306036,
"base": "USD",
"date": "2026-08-09",
"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 comprehensive and innovative solution for accessing SPDR Gold Shares (GLD) exchange rates and other precious metals data in JSON format. By leveraging its extensive features and endpoints, developers can create powerful applications that enhance trading strategies and provide valuable market insights.

With capabilities ranging from real-time exchange rates to historical data analysis, the Metals-API empowers users to make informed decisions and optimize their trading experiences. For further exploration of the API's functionalities, be sure to check out the Metals-API Documentation and the Symbols List.

In a world where data is king, the Metals-API stands out as a vital resource for developers seeking to harness the power of real-time metals data. By integrating this API into your applications, you can unlock new possibilities for innovation and market analysis, ultimately driving success in the dynamic world of precious metals trading.

Ready to use Metals-API?

Try it now!

Access SPDR Gold Shares (GLD) Exchange Rate API Documentation in JSON Format