Access Hot Rolled Coil China Spot (HRC-CH) API Documentation for JSON Format

In today's rapidly evolving digital landscape, the demand for real-time data in the metal markets has never been more critical. The Metals-API provides developers with the tools necessary to access and integrate exchange rates for various metals, including the Hot Rolled Coil China Spot (HRC-CH), in JSON format. This blog post will guide you through the process of retrieving exchange rates using the Metals-API, showcasing sample API responses and offering integration tips to enhance your applications.

About Hot Rolled Coil China Spot (HRC-CH)

The Hot Rolled Coil China Spot (HRC-CH) is a crucial indicator in the global metal market, reflecting the real-time pricing of hot rolled steel coils in China. As industries undergo digital transformation, the integration of advanced technologies and data analytics becomes paramount. The Metals-API empowers developers to harness the power of real-time data, enabling them to create innovative applications that can analyze market trends, forecast prices, and provide insights into the fluctuating metal markets.

Technological advancements in data analytics and smart technology integration are reshaping how businesses operate within the metal industry. By leveraging APIs like Metals-API, developers can build applications that not only retrieve current market rates but also analyze historical data, track fluctuations, and convert between different metal currencies. This capability opens up new possibilities for businesses looking to optimize their operations and make informed decisions based on accurate data.

API Description

The Metals-API is designed to provide developers with access to a wide range of functionalities related to metal pricing and currency conversion. With a focus on innovation and technological advancement, this API enables the retrieval of real-time and historical data, empowering developers to build next-generation applications. The API supports various endpoints, each tailored to specific needs, including the latest rates, historical rates, and conversion functionalities.

For more detailed information, you can refer to the Metals-API Documentation, which outlines the capabilities and features of the API. Additionally, the Metals-API Supported Symbols page provides a comprehensive list of all available metal symbols, including HRC-CH.

Key Features and Endpoints

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

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated based on your subscription plan. Depending on the plan, updates can occur every 60 minutes or even every 10 minutes, ensuring you have the most current information at your fingertips.
Historical Rates Endpoint: Access historical exchange rates dating back to 2019. By appending a specific date to your query, you can retrieve past rates, allowing for comprehensive analysis and trend identification.
Bid And Ask Endpoint: This powerful feature allows you to retrieve real-time bid and ask prices for metals, providing insight into market dynamics and helping you make informed trading decisions.
Convert Endpoint: The conversion endpoint enables you to convert any amount from one metal to another or to/from USD. This is particularly useful for businesses operating in multiple currencies.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, allowing for in-depth analysis of price movements over time.
Fluctuation Endpoint: Track how metal prices fluctuate on a day-to-day basis, providing valuable insights into market volatility.
Carat Endpoint: Retrieve information about gold rates by carat, which is essential for jewelers and gold traders.
Lowest/Highest Price Endpoint: This endpoint allows you to query the API for the lowest and highest prices over a specified period, aiding in market analysis.
Open/High/Low/Close (OHLC) Price Endpoint: Get detailed OHLC data for a specific time period, which is crucial for traders looking to analyze market trends.
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 essential for accessing the API and must be included in your requests.
API Response: The API delivers exchange rates relative to USD by default, ensuring consistency in your data.
Available Endpoints: With 14 different API endpoints, each providing unique functionalities, developers have a wealth of options to choose from.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market developments.

API Endpoint Examples and Responses

To illustrate the capabilities of the Metals-API, let's explore some example responses from various endpoints.

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

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

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-02-16",
"end_date": "2026-02-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": 1771816031,
"base": "USD",
"date": "2026-02-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": 1771816031,
"base": "USD",
"date": "2026-02-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"
}

Integration Tips

Integrating the Metals-API into your applications can significantly enhance your ability to analyze and respond to market changes. Here are some practical tips for successful integration:

Authentication and Authorization: Ensure that you securely store your API key and include it in all requests. This key is essential for accessing the API and should be treated as sensitive information.
Rate Limiting and Quota Management: Be aware of your subscription plan's rate limits to avoid exceeding your quota. Implement error handling to gracefully manage rate limit errors.
Error Handling: Design your application to handle various error scenarios, including network issues and invalid requests. Providing meaningful error messages can help users understand what went wrong.
Data Validation: Validate all input data before sending requests to the API to prevent unnecessary errors and ensure data integrity.
Performance Optimization: Consider caching frequently accessed data to reduce API calls and improve application performance. This is especially important for endpoints that provide historical data.
Security Best Practices: Use HTTPS for all API requests to ensure data is transmitted securely. Regularly review your API usage and access logs for any suspicious activity.

Conclusion

The Metals-API provides a powerful and flexible solution for developers looking to access real-time and historical data on metal prices, including the Hot Rolled Coil China Spot (HRC-CH). By leveraging the various endpoints offered by the API, developers can create applications that analyze market trends, track fluctuations, and convert between different metal currencies.

With a focus on innovation and technological advancement, the Metals-API empowers businesses to make informed decisions based on accurate data. As industries continue to evolve, the integration of real-time data into applications will be essential for staying competitive in the market.

For more information on how to get started with the Metals-API, visit the Metals-API Documentation and explore the Metals-API Supported Symbols page for a complete list of available metal symbols. Start building your next-generation applications today with the power of real-time metals data!

Ready to use Metals-API?

Try it now!

Access Hot Rolled Coil China Spot (HRC-CH) API Documentation for JSON Format