Access Aluminum Sep 2025 (ALU25) API Usage Examples in JSON Format

In the rapidly evolving landscape of metal markets, the ability to access real-time data is paramount for developers and businesses alike. The Metals-API provides a robust platform for retrieving exchange rates and other vital information related to metals, including Aluminum (XAL). This blog post will delve into the various capabilities of the Metals-API, focusing on how to retrieve Gold (XAU) exchange rates in JSON format, complete with sample API responses and integration tips.

Metals-API Information

About Aluminum (XAL)

Aluminum is a versatile metal widely used in various industries, from aerospace to packaging. As digital transformation continues to reshape the metal markets, the integration of smart technologies and data analytics is becoming increasingly important. The Metals-API stands at the forefront of this transformation, offering developers the tools they need to harness real-time metals data effectively. By leveraging this API, developers can create applications that provide insights into market trends, optimize supply chains, and enhance decision-making processes.

API Description

The Metals-API is designed to empower developers by providing access to real-time and historical data on metal prices. With capabilities that include retrieving the latest rates, historical data, and conversion functionalities, the API enables the development of next-generation applications that can adapt to the dynamic nature of metal markets. For more detailed information, you can visit the Metals-API Website or explore the Metals-API Documentation.

Key Features and Endpoints

The Metals-API offers a variety of endpoints, each designed to cater to specific needs. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data, updated based on your subscription plan. Developers can access the latest rates for various metals, including Gold (XAU), Silver (XAG), and Aluminum (XAL).
Historical Rates Endpoint: Access historical exchange rates dating back to 2019 by appending a specific date to the API request. This feature is invaluable for analyzing market trends over time.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing for precise trading and investment decisions.
Convert Endpoint: This endpoint enables the conversion of any amount from one metal to another or to/from USD, making it easier for developers to integrate currency conversion functionalities into their applications.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, providing insights into price movements over time.
Fluctuation Endpoint: Track how metal prices fluctuate on a day-to-day basis, which is essential for understanding market volatility.
Carat Endpoint: Retrieve information about Gold rates by Carat, which is particularly useful for jewelers and traders.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specified date, aiding in market analysis.
Open/High/Low/Close (OHLC) Price Endpoint: Access OHLC data for a specific time period, which is crucial for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a comprehensive view of market trends.
API Key: Your unique API key is required for authentication and must be included in your API requests.
API Response: The API delivers exchange rates relative to USD, ensuring consistency across responses.
Available Endpoints: The Metals-API includes 14 endpoints, each offering different functionalities to cater to diverse developer needs.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals.
Intraday Endpoint: Query intraday exchange rate data for a single symbol, which is essential for high-frequency trading applications.

List of Symbols

The 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

Latest Rates Endpoint

To get real-time exchange rates for all available metals, you can use the Latest Rates Endpoint. Below is an example of the JSON response you might receive:

{
"success": true,
"timestamp": 1785694042,
"base": "USD",
"date": "2026-08-02",
"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"
}

In this response, the "rates" object contains the exchange rates for various metals, with "XAU" representing Gold. The "unit" indicates that these rates are measured per troy ounce.

Historical Rates Endpoint

Accessing historical exchange rates is crucial for market analysis. Here’s an example response from the Historical Rates Endpoint:

{
"success": true,
"timestamp": 1785607642,
"base": "USD",
"date": "2026-08-01",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}

This response shows the historical rates for Gold and other metals on a specific date, allowing developers to analyze price movements over time.

Time-series Endpoint

The Time-series Endpoint allows you to retrieve exchange rates for a specific time period. Below is an example response:

{
"success": true,
"timeseries": true,
"start_date": "2026-07-26",
"end_date": "2026-08-02",
"base": "USD",
"rates": {
"2026-07-26": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-07-28": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-08-02": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

This response provides daily exchange rates for Gold over a specified period, which is essential for trend analysis and forecasting.

Convert Endpoint

The Convert Endpoint is particularly useful for applications that require currency conversion. Here’s an example response:

{
"success": true,
"query": {
"from": "USD",
"to": "XAU",
"amount": 1000
},
"info": {
"timestamp": 1785694042,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

This response indicates that 1000 USD is equivalent to 0.482 troy ounces of Gold, based on the current exchange rate.

Fluctuation Endpoint

Tracking rate fluctuations is vital for understanding market dynamics. Below is an example response from the Fluctuation Endpoint:

{
"success": true,
"fluctuation": true,
"start_date": "2026-07-26",
"end_date": "2026-08-02",
"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"
}

This response provides insights into how the price of Gold has changed over a specified period, including both absolute and percentage changes.

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

For technical analysis, the OHLC Price Endpoint is invaluable. Here’s an example response:

{
"success": true,
"timestamp": 1785694042,
"base": "USD",
"date": "2026-08-02",
"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"
}

This response provides the opening, highest, lowest, and closing prices for Gold on a specific date, which is essential for traders and analysts.

Bid/Ask Endpoint

Finally, the Bid/Ask Endpoint allows you to get current bid and ask prices for metals. Below is an example response:

{
"success": true,
"timestamp": 1785694042,
"base": "USD",
"date": "2026-08-02",
"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"
}

This response provides the current bid and ask prices for Gold, which is crucial for traders looking to make informed decisions.

Conclusion

The Metals-API is a powerful tool for developers looking to access real-time and historical data on metals, including Gold (XAU). By utilizing the various endpoints available, developers can create applications that provide valuable insights into market trends, optimize trading strategies, and enhance decision-making processes. Whether you are interested in retrieving the latest rates, historical data, or performing conversions, the Metals-API offers comprehensive solutions tailored to meet your needs.

For further exploration of the API's capabilities, be sure to check out the Metals-API Documentation and the Metals-API Supported Symbols page. With the right tools and data at your fingertips, the possibilities for innovation in the metal markets are limitless.

Ready to use Metals-API?

Try it now!

Access Aluminum Sep 2025 (ALU25) API Usage Examples in JSON Format