Fetch Chinese Renminbi Yuan Offshore (CNH) prices through this API

Introduction

The Chinese Renminbi Yuan Offshore (CNH) is a crucial currency in the global financial landscape, especially in the context of international trade and investment. As the world increasingly embraces digital transformation, the demand for real-time data on currency exchange rates has surged. This is where the Metals-API comes into play, offering developers a robust platform to fetch CNH prices and other metal-related data seamlessly. This blog post delves into the intricacies of the Metals-API, highlighting its features, capabilities, and the transformative potential it holds for developers and businesses alike.

About Chinese Renminbi Yuan (CNY)

The Chinese Renminbi (CNY) has evolved significantly over the years, particularly with the rise of the offshore market (CNH). This evolution is not just a financial phenomenon but also a reflection of technological innovation and advancement in the metal markets. The integration of smart technology and data analytics has paved the way for more informed decision-making in trading and investment.

As digital transformation continues to reshape the financial landscape, the ability to access real-time data on currency fluctuations and metal prices becomes paramount. Developers can leverage this data to build next-generation applications that enhance trading strategies, optimize investment portfolios, and provide valuable insights into market trends.

API Description

The Metals-API is a powerful tool designed to provide real-time and historical data on metal prices and currency exchange rates, including the Chinese Renminbi Yuan Offshore (CNH). This API empowers developers to create applications that can analyze market trends, perform currency conversions, and track price fluctuations with precision.

With its user-friendly interface and comprehensive documentation, the Metals-API Documentation serves as an essential resource for developers looking to integrate this API into their projects. The API supports a wide range of functionalities, making it a versatile choice for various applications in finance and trading.

Key Features and Endpoints

The Metals-API offers a plethora of features that cater to the diverse needs of developers. Here are some of the key functionalities:

Latest Rates Endpoint

The Latest Rates Endpoint provides real-time exchange rate data for various currencies, including CNH. Depending on your subscription plan, this endpoint updates every 60 minutes or every 10 minutes, ensuring that you have the most current information at your fingertips. This feature is particularly useful for traders who need to make quick decisions based on the latest market movements.

{
"success": true,
"timestamp": 1781741366,
"base": "USD",
"date": "2026-06-18",
"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

The Historical Rates Endpoint allows users to access historical exchange rates dating back to 2019. This feature is invaluable for analyzing trends over time and making informed predictions about future market behavior. By appending a specific date in the format YYYY-MM-DD, developers can retrieve historical data for any currency, including CNH.

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

Bid And Ask Endpoint

The Bid and Ask Endpoint is a powerful feature that enables developers to retrieve real-time bid and ask prices for metals. This information is crucial for traders looking to execute orders at the best possible prices. Depending on your subscription plan, this endpoint provides insights into the current market spread, allowing for more strategic trading decisions.

{
"success": true,
"timestamp": 1781741366,
"base": "USD",
"date": "2026-06-18",
"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"
}

Convert Endpoint

The Convert Endpoint allows users to convert any amount from one currency to another, including conversions to and from USD. This feature is particularly useful for businesses engaged in international trade, as it simplifies the process of calculating costs and revenues in different currencies.

{
"success": true,
"query": {
"from": "USD",
"to": "XAU",
"amount": 1000
},
"info": {
"timestamp": 1781741366,
"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 conducting in-depth analyses of market trends and understanding how currency values fluctuate over time.

{
"success": true,
"timeseries": true,
"start_date": "2026-06-11",
"end_date": "2026-06-18",
"base": "USD",
"rates": {
"2026-06-11": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-06-13": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-06-18": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

Fluctuation Endpoint

The Fluctuation Endpoint provides insights into how currencies fluctuate on a day-to-day basis. By tracking rate changes between two dates, developers can gain a better understanding of market volatility and make more informed trading decisions.

{
"success": true,
"fluctuation": true,
"start_date": "2026-06-11",
"end_date": "2026-06-18",
"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"
}

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

The OHLC Price Endpoint allows developers to query the API for open, high, low, and close prices for a specific time period. This data is critical for traders who rely on technical analysis to inform their trading strategies.

{
"success": true,
"timestamp": 1781741366,
"base": "USD",
"date": "2026-06-18",
"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"
}

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 businesses involved in trading metals, as it allows for comprehensive analysis of historical price movements.

API Key and Response

To access the Metals-API, developers must use a unique API Key, which is passed into the API base URL's access_key parameter. The API delivers exchange rates relative to USD by default, ensuring consistency in data interpretation.

All data is returned in a structured JSON format, making it easy for developers to parse and utilize in their applications. The response includes fields such as success, timestamp, base currency, date, rates, and unit, providing comprehensive information for each request.

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. This resource is invaluable for developers looking to integrate specific metals into their applications.

Conclusion

The Chinese Renminbi Yuan Offshore (CNH) plays a pivotal role in the global financial markets, and the Metals-API offers a powerful solution for developers seeking to access real-time and historical data on currency exchange rates and metal prices. By leveraging the capabilities of this API, developers can create innovative applications that enhance trading strategies, optimize investment decisions, and provide valuable insights into market trends.

With features such as the Latest Rates Endpoint, Historical Rates Endpoint, and Bid and Ask Endpoint, the Metals-API stands out as a versatile tool for financial analysis. As the market continues to evolve, the integration of advanced data analytics and smart technology will be crucial for staying ahead in the competitive landscape of currency trading and investment.

For more information on how to get started with the Metals-API, visit the Metals-API Website and explore the extensive Metals-API Documentation for detailed guidance on implementation and usage.