Access Iron Ore 62% Fe CFR China (IRON62) JSON Format API Documentation for Developers

Metals-API 6 min read
Access Iron Ore 62% Fe CFR China (IRON62) JSON Format API Documentation for Developers

Introduction

In the ever-evolving landscape of financial technology, the ability to access real-time data is crucial for developers working with commodities like gold. The Metals-API provides a robust solution for retrieving Gold (XAU) exchange rates in JSON format, enabling developers to build applications that require accurate and timely data. This blog post will delve into the capabilities of the Metals-API, focusing on how to effectively utilize its features to retrieve Gold exchange rates, along with practical integration tips and sample API responses.

Understanding the Metals-API

The Metals-API is a powerful tool designed for developers seeking to integrate real-time metals data into their applications. It offers a variety of endpoints that allow users to access current and historical exchange rates for various metals, including gold, silver, platinum, and palladium. By leveraging this API, developers can create applications that provide insights into market trends, perform currency conversions, and analyze historical data.

About Iron Ore (IRON)

While our primary focus is on gold, it's worth noting the broader context of metals trading. The digital transformation in metal markets has led to significant advancements in how data is collected, analyzed, and utilized. Technologies such as data analytics and smart technology integration are reshaping the landscape, allowing for more informed decision-making and strategic planning. The Metals-API stands at the forefront of this transformation, providing developers with the tools necessary to harness the power of real-time data.

API Description

The Metals-API is designed to empower developers by providing access to a wide range of functionalities. With its innovative approach to data delivery, the API allows for seamless integration into various applications, from trading platforms to financial analysis tools. The API's capabilities include retrieving the latest rates, historical data, bid and ask prices, and much more, all in a user-friendly JSON format.

For more detailed information, developers can refer to the Metals-API Documentation, which outlines the various endpoints and their functionalities.

Key Features of the Metals-API

The Metals-API boasts a range of features that cater to the diverse needs of developers. Below, we explore some of the most significant endpoints and their applications:

Latest Rates Endpoint

The Latest Rates Endpoint provides real-time exchange rate data for metals, updated based on the user's subscription plan. This endpoint is essential for applications that require up-to-the-minute pricing information. Depending on the subscription, updates can occur every 60 minutes or even every 10 minutes.

{
"success": true,
"timestamp": 1784455658,
"base": "USD",
"date": "2026-07-19",
"rates": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"XPD": 0.000744
},
"unit": "per troy ounce"
}

Historical Rates Endpoint

Accessing historical rates is crucial for trend analysis and market research. The Historical Rates Endpoint allows developers to query rates dating back to 2019 by appending a specific date to the request. This feature is particularly useful for applications that analyze market trends over time.

{
"success": true,
"timestamp": 1784369258,
"base": "USD",
"date": "2026-07-18",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"unit": "per troy ounce"
}

Bid And Ask Endpoint

The Bid and Ask Endpoint is a powerful feature that provides real-time bid and ask prices for metals. This information is vital for traders who need to make informed decisions based on current market conditions.

{
"success": true,
"timestamp": 1784455658,
"base": "USD",
"date": "2026-07-19",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
},
"XAG": {
"bid": 0.0381,
"ask": 0.0382,
"spread": 0.0001
}
},
"unit": "per troy ounce"
}

Convert Endpoint

The Convert Endpoint allows developers to convert any amount from one metal to another or to/from USD. This feature is particularly useful for applications that require currency conversion capabilities.

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

Time-Series Endpoint

The Time-Series Endpoint enables developers to query the API for daily historical rates between two specified dates. This feature is essential for applications that analyze price movements over time.

{
"success": true,
"timeseries": true,
"start_date": "2026-07-12",
"end_date": "2026-07-19",
"base": "USD",
"rates": {
"2026-07-12": {
"XAU": 0.000485,
"XAG": 0.03825
},
"2026-07-19": {
"XAU": 0.000482,
"XAG": 0.03815
}
},
"unit": "per troy ounce"
}

Fluctuation Endpoint

The Fluctuation Endpoint provides insights into how currencies fluctuate on a day-to-day basis. This information is crucial for traders and analysts who need to understand market volatility.

{
"success": true,
"fluctuation": true,
"start_date": "2026-07-12",
"end_date": "2026-07-19",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482,
"change": -3.0e-6,
"change_pct": -0.62
}
},
"unit": "per troy ounce"
}

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

The OHLC Price Endpoint allows developers to retrieve the open, high, low, and close prices for a specific time period. This data is essential for technical analysis and trading strategies.

{
"success": true,
"timestamp": 1784455658,
"base": "USD",
"date": "2026-07-19",
"rates": {
"XAU": {
"open": 0.000485,
"high": 0.000487,
"low": 0.000481,
"close": 0.000482
}
},
"unit": "per troy ounce"
}

Historical LME Endpoint

The Historical LME Endpoint provides access to historical rates for LME symbols dating back to 2008. This endpoint is particularly useful for developers working with industrial metals.

{
"success": true,
"timestamp": 1784369258,
"base": "USD",
"date": "2026-07-18",
"rates": {
"XCU": 0.294118,
"XAL": 0.434783
},
"unit": "per troy ounce"
}

API Key and Authentication

To access the Metals-API, developers must obtain an API key, which is passed into the API base URL's access_key parameter. This key is essential for authentication and ensures that only authorized users can access the data.

API Response Structure

The API responses are structured in a consistent JSON format, making it easy for developers to parse and utilize the data. Each response includes fields such as success, timestamp, base currency, date, rates, and unit, providing comprehensive information about the requested data.

Integration Tips

Integrating the Metals-API into your application can significantly enhance its functionality. Here are some practical tips for successful integration:

  • Understand the API Structure: Familiarize yourself with the API endpoints and their respective parameters to ensure you can effectively retrieve the data you need.
  • Handle API Responses: Implement robust error handling to manage potential issues, such as rate limits or invalid requests. Ensure your application can gracefully handle these scenarios.
  • Optimize Performance: Consider caching frequently accessed data to reduce API calls and improve response times. This is particularly important for applications that require real-time data.
  • Security Best Practices: Always secure your API key and avoid exposing it in client-side code. Use server-side requests to keep your key confidential.

Conclusion

The Metals-API offers a comprehensive solution for developers looking to integrate gold exchange rates and other metal data into their applications. With its wide range of endpoints, real-time data capabilities, and user-friendly JSON format, the API empowers developers to create innovative financial applications. By understanding the various features and implementing best practices for integration, developers can harness the full potential of the Metals-API.

For further exploration, visit the Metals-API Website to access the full documentation and supported symbols list. Whether you're building a trading platform or a financial analysis tool, the Metals-API provides the data you need to succeed in today's dynamic market.