Access Chinese Renminbi Yuan Offshore (CNH) Exchange Rates for API Integration in JSON Format

In today's global economy, accessing real-time exchange rates is crucial for businesses and developers alike. The ability to retrieve Chinese Renminbi Yuan Offshore (CNH) exchange rates in JSON format can significantly enhance financial applications, trading platforms, and market analysis tools. Utilizing the Metals-API provides developers with a powerful tool to integrate comprehensive metals and currency data into their applications. This blog post will delve into the capabilities of the Metals-API, focusing on how to access CNH exchange rates, explore various endpoints, and provide practical integration tips.

Metals-API Information

About Tellurium (TE)

As the world embraces digital transformation, the metal markets are also evolving. The integration of technological innovation and advancement is reshaping how metals are traded and analyzed. Data analytics and insights are becoming increasingly important, allowing stakeholders to make informed decisions based on real-time data. Smart technology integration is paving the way for future trends, enabling developers to create next-generation applications that leverage the power of real-time metals data.

API Description

The Metals-API is a robust platform that provides real-time and historical data on metals and currencies, including the Chinese Renminbi Yuan Offshore (CNH). This API empowers developers to build applications that require accurate and timely information, facilitating better decision-making in trading and investment. With its innovative features, the Metals-API transforms how developers interact with financial data, enabling seamless integration into various applications.

For detailed information on how to use the API, refer to the Metals-API Documentation. The documentation provides comprehensive guidance on authentication, available endpoints, and response formats.

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. For example, accessing the latest rates for CNH allows you to stay updated on market fluctuations.
Historical Rates Endpoint: Historical rates are available for most currencies dating back to 2019. You can query the Metals-API for historical rates by appending a date in the format YYYY-MM-DD. This feature is particularly useful for analyzing trends over time.
Bid And Ask Endpoint: This powerful feature enables you to retrieve real-time bid and ask prices for metals, including CNH. Understanding the bid-ask spread is essential for traders looking to optimize their transactions.
Convert Endpoint: The Metals-API includes a currency conversion endpoint, allowing you to convert any amount from one currency to another. This is particularly useful for applications that require real-time conversion rates.
Time-Series Endpoint: This endpoint allows you to query the API for daily historical rates between two dates of your choice. It is beneficial for developers looking to analyze trends over specific periods.
Fluctuation Endpoint: With this endpoint, you can retrieve information about how currencies fluctuate on a day-to-day basis, providing insights into market volatility.
Carat Endpoint: This feature allows you to retrieve information about gold rates by carat, which can be useful for jewelers and investors in precious metals.
Lowest/Highest Price Endpoint: This endpoint enables you to query the API to get the lowest and highest price for a specified date, helping traders identify market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific date, essential for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, which is crucial for understanding long-term market trends.
API Key: Your API Key is essential for accessing the API and must be included in the API base URL's access_key parameter.
API Response: Exchange rates delivered by the Metals-API are by default relative to USD, ensuring consistency across responses.
Available Endpoints: The Metals-API comes with 14 API endpoints, each providing different functionalities tailored to various needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, including CNH, allowing developers to stay informed about supported symbols.
News Endpoint: Retrieve the latest news articles related to various metals, providing context and insights into market movements.

For a comprehensive list of all supported symbols and their specifications, refer to the Metals-API Supported Symbols.

API Endpoint Examples and Responses

Latest Rates Endpoint

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

{
"success": true,
"timestamp": 1776283655,
"base": "USD",
"date": "2026-04-15",
"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,
"CNH": 0.0065
},
"unit": "per troy ounce"
}

Historical Rates Endpoint

Access historical exchange rates for any date since 1999 using the Historical Rates Endpoint. Here’s an example response:

{
"success": true,
"timestamp": 1776197255,
"base": "USD",
"date": "2026-04-14",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748,
"CNH": 0.0064
},
"unit": "per troy ounce"
}

Time-series Endpoint

To get exchange rates for a specific time period, you can use the Time-series Endpoint. Below is an example response:

{
"success": true,
"timeseries": true,
"start_date": "2026-04-08",
"end_date": "2026-04-15",
"base": "USD",
"rates": {
"2026-04-08": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"CNH": 0.0063
},
"2026-04-10": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913,
"CNH": 0.0064
},
"2026-04-15": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"CNH": 0.0065
}
},
"unit": "per troy ounce"
}

Convert Endpoint

The Convert Endpoint allows you to convert any amount from one metal to another or to/from USD. Here’s an example response:

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

Fluctuation Endpoint

Track rate fluctuations between two dates using the Fluctuation Endpoint. Below is an example response:

{
"success": true,
"fluctuation": true,
"start_date": "2026-04-08",
"end_date": "2026-04-15",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482,
"change": -3.0e-6,
"change_pct": -0.62
},
"CNH": {
"start_rate": 0.0063,
"end_rate": 0.0065,
"change": 0.0002,
"change_pct": 3.17
}
},
"unit": "per troy ounce"
}

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period using the OHLC Endpoint. Here’s an example response:

{
"success": true,
"timestamp": 1776283655,
"base": "USD",
"date": "2026-04-15",
"rates": {
"XAU": {
"open": 0.000485,
"high": 0.000487,
"low": 0.000481,
"close": 0.000482
},
"CNH": {
"open": 0.0064,
"high": 0.0065,
"low": 0.0063,
"close": 0.0065
}
},
"unit": "per troy ounce"
}

Bid/Ask Endpoint

Retrieve current bid and ask prices for metals using the Bid/Ask Endpoint. Below is an example response:

{
"success": true,
"timestamp": 1776283655,
"base": "USD",
"date": "2026-04-15",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
},
"CNH": {
"bid": 0.0064,
"ask": 0.0065,
"spread": 0.0001
}
},
"unit": "per troy ounce"
}

Integration Tips

When integrating the Metals-API into your applications, consider the following tips:

Authentication: Ensure that you securely store your API key and include it in your requests to authenticate your access.
Rate Limiting: Be aware of the rate limits associated with your subscription plan to avoid exceeding your quota.
Error Handling: Implement robust error handling to manage potential issues such as network errors or invalid requests.
Data Caching: Consider caching frequently accessed data to improve performance and reduce the number of API calls.
Security Best Practices: Always use HTTPS for API requests to ensure data security during transmission.

Conclusion

Accessing Chinese Renminbi Yuan Offshore (CNH) exchange rates through the Metals-API opens up a world of possibilities for developers looking to enhance their financial applications. With a variety of endpoints that provide real-time and historical data, the Metals-API empowers developers to create innovative solutions that meet the demands of today's fast-paced financial markets. By leveraging the capabilities of the Metals-API, you can build applications that not only provide accurate exchange rates but also deliver valuable insights into market trends.

For more information on how to get started, visit the Metals-API Website and explore the Metals-API Documentation for detailed guidance on implementation. Don't forget to check the Metals-API Supported Symbols page to ensure you have access to all the necessary currency symbols for your applications.

Ready to use Metals-API?

Try it now!

Access Chinese Renminbi Yuan Offshore (CNH) Exchange Rates for API Integration in JSON Format