The Easiest Way to Get Iron Ore China Spot (IRON-CH) Historical Rates through API Documentation

In the fast-paced world of metal trading, having access to accurate and timely data is crucial for making informed decisions. The Metals-API provides a robust solution for developers looking to integrate real-time and historical metal prices, including Iron Ore (IRON-CH), into their applications. This blog post will guide you through the process of retrieving historical prices for Gold (XAU) using the Metals-API, while also touching on the broader implications of digital transformation in the metal markets.

About Iron Ore (IRON)

Iron Ore is a critical component in the production of steel, which is essential for various industries, including construction, automotive, and manufacturing. As the demand for steel continues to rise, understanding the historical prices of Iron Ore becomes increasingly important for traders and investors. The Metals-API not only offers real-time data but also empowers users with historical insights that can drive strategic decisions.

In today's digital landscape, technological innovation and advancement play a pivotal role in the metal markets. The integration of smart technologies and data analytics allows stakeholders to gain valuable insights into market trends, enabling them to anticipate fluctuations and make data-driven decisions. The Metals-API exemplifies this transformation by providing developers with the tools necessary to build next-generation applications that leverage real-time metals data.

API Description

The Metals-API is a powerful JSON API that provides access to a wide range of metal prices and currency conversion functionalities. With a focus on innovation and technological advancement, this API allows developers to create applications that can respond to market changes in real-time. Whether you are building a trading platform or a financial analysis tool, the Metals-API offers the capabilities you need to succeed.

For more information, you can visit the Metals-API Website or check out the Metals-API Documentation for detailed guidance on implementation.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data, updated every 60 minutes, every 10 minutes, or even more frequently, depending on your subscription plan. It allows you to access the most current prices for Iron Ore and other metals.
Historical Rates Endpoint: With this feature, you can access historical rates for Iron Ore dating back to 2019. By appending a specific date in the format YYYY-MM-DD, you can retrieve the price for that particular day.
Bid And Ask Endpoint: This powerful feature enables you to retrieve real-time Bid and Ask prices for Iron Ore, allowing traders to make informed decisions based on market conditions.
Convert Endpoint: The Metals-API includes a currency conversion endpoint that allows you to convert any amount from one metal to another or to/from USD, facilitating seamless transactions.
Time-Series Endpoint: This endpoint allows you to query the API for daily historical rates between two dates of your choice, providing a comprehensive view of price trends over time.
Fluctuation Endpoint: With this feature, you can track how Iron Ore prices fluctuate on a day-to-day basis, offering insights into market volatility.
Lowest/Highest Price Endpoint: This endpoint allows you to query the API to get the lowest and highest prices for Iron Ore over a specified period.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides detailed price data, including the open, high, low, and close prices for Iron Ore, which is essential for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols, dating back to 2008, which is crucial for understanding long-term trends in the metal markets.
API Key: Your unique API Key is required to access the API, ensuring secure and authorized usage.
API Response: The API delivers exchange rates relative to USD, with all data returned in a structured JSON format.
Available Endpoints: The Metals-API comes with 14 endpoints, each providing different functionalities to cater to various user needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies and metals, ensuring you have the latest information.
Intraday Endpoint: Query intraday exchange rate data for a single symbol, allowing for real-time trading strategies.

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

To illustrate how to retrieve historical prices for Gold (XAU) using the Metals-API, let's explore some example endpoints and their corresponding responses.

Latest Rates Endpoint

To get real-time exchange rates for all available metals, you can use the following endpoint:

GET /latest

Example Response:

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

Historical Rates Endpoint

To access historical exchange rates for any date since 1999, you can use the following endpoint:

GET /historical?date=YYYY-MM-DD

Example Response:

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

Time-Series Endpoint

To get exchange rates for a specific time period, you can use the following endpoint:

GET /timeseries?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD

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
},
"2026-08-02": {
"XAU": 0.000482,
"XAG": 0.03815
}
},
"unit": "per troy ounce"
}

Convert Endpoint

To convert any amount from one metal to another or to/from USD, you can use the following endpoint:

GET /convert?from=USD&to=XAU&amount=1000

Example Response:

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

Fluctuation Endpoint

To track rate fluctuations between two dates, you can use the following endpoint:

GET /fluctuation?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD

Example Response:

{
"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
}
},
"unit": "per troy ounce"
}

OHLC (Open/High/Low/Close) Endpoint

To get OHLC data for a specific time period, you can use the following endpoint:

GET /open-high-low-close?date=YYYY-MM-DD

Example Response:

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

Bid/Ask Endpoint

To get current bid and ask prices for metals, you can use the following endpoint:

GET /bid-ask

Example Response:

{
"success": true,
"timestamp": 1785668891,
"base": "USD",
"date": "2026-08-02",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
}
},
"unit": "per troy ounce"
}

Conclusion

In conclusion, the Metals-API offers a comprehensive solution for developers looking to access historical and real-time data for Iron Ore and other metals. By leveraging the various endpoints available, you can build applications that provide valuable insights into market trends and fluctuations. Whether you are interested in the latest rates, historical data, or conversion capabilities, the Metals-API has the tools you need to succeed in the competitive metal trading landscape.

For further exploration, consider visiting the Metals-API Documentation for detailed implementation guidance, or check the Metals-API Supported Symbols page for a complete list of available symbols. By integrating these capabilities into your applications, you can harness the power of real-time data to drive your trading strategies and decision-making processes.

Ready to use Metals-API?

Try it now!

The Easiest Way to Get Iron Ore China Spot (IRON-CH) Historical Rates through API Documentation