Retrieve Chinese Renminbi Yuan (CNY) Historical Prices from this API

The Chinese Renminbi Yuan (CNY) is a significant currency in the global market, especially as China continues to expand its economic influence. For developers and financial analysts looking to retrieve historical prices of CNY, the Metals-API offers a robust solution. This blog post will explore the capabilities of the Metals-API, focusing on how to access historical prices, the technological innovations behind the API, and the transformative potential of real-time metals data.

About Chinese Renminbi Yuan (CNY)

The Chinese Renminbi (RMB) is the official currency of the People's Republic of China, and its primary unit is the Yuan (CNY). As the world's second-largest economy, China's currency plays a crucial role in international trade and finance. The digital transformation in metal markets has led to an increased demand for accurate and timely data regarding currency fluctuations, especially for CNY. With the rise of technological innovations and advancements in data analytics, developers can now leverage APIs to gain insights into currency trends and make informed decisions.

Technological innovation has paved the way for smart technology integration in financial markets. The Metals-API stands out as a powerful tool that provides real-time and historical data on various metals and currencies, including CNY. By utilizing data analytics, developers can extract valuable insights that can drive strategic decisions in trading and investment.

API Description

The Metals-API is a comprehensive solution for accessing real-time and historical data on metals and currencies. It empowers developers to build next-generation applications that require accurate and timely data. The API provides a wide range of endpoints, each designed to cater to different data needs. Whether you are looking for the latest exchange rates, historical prices, or detailed analytics, the Metals-API has you covered.

For more information, 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 several key features that enhance its usability for developers:

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. This feature is essential for applications that require up-to-the-minute data on currency fluctuations.
Historical Rates Endpoint: Users can access historical rates for most currencies dating back to 2019. By appending a specific date to the API request, developers can retrieve historical exchange rates for CNY, enabling them to analyze trends over time.
Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices for metals, providing insights into market conditions and helping traders make informed decisions.
Convert Endpoint: The API includes a currency conversion endpoint, allowing users to convert any amount from one currency to another. This is particularly useful for applications that require dynamic currency conversion based on real-time rates.
Time-Series Endpoint: Developers can query the API for daily historical rates between two dates of their choice. This feature is invaluable for analyzing trends and fluctuations over specific periods.
Fluctuation Endpoint: This endpoint provides information about how currencies fluctuate on a day-to-day basis, allowing users to track changes and make predictions based on historical data.
Carat Endpoint: Users can retrieve information about gold rates by carat, which is essential for jewelers and investors in precious metals.
Lowest/Highest Price Endpoint: This feature allows users to query the API to get the lowest and highest prices for a specified date, providing insights into market volatility.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific date, which is crucial for traders looking to analyze market performance.
Historical LME Endpoint: Users can access historical rates for LME symbols dating back to 2008, which is particularly useful for those involved in trading metals on the London Metal Exchange.
API Key: Each user is assigned a unique API key that must be included in requests to authenticate access to the API.
API Response: The Metals-API returns exchange rates relative to USD by default, ensuring consistency in data presentation.
Available Endpoints: The API comes with 14 endpoints, each providing different functionalities tailored to various user needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, allowing users to stay informed about the latest symbols supported by the API.
News Endpoint: Users can retrieve the latest news articles related to various metals, keeping them updated on market trends and developments.

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

Understanding the API responses is crucial for developers looking to integrate the Metals-API into their applications. Below are examples of various endpoints and their corresponding JSON responses:

Latest Rates Endpoint

{
"success": true,
"timestamp": 1771287754,
"base": "USD",
"date": "2026-02-17",
"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"
}

This response indicates that the request was successful and provides the latest exchange rates for various metals relative to USD.

Historical Rates Endpoint

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

This example shows how to retrieve historical exchange rates for a specific date, allowing developers to analyze past performance.

Time-series Endpoint

{
"success": true,
"timeseries": true,
"start_date": "2026-02-10",
"end_date": "2026-02-17",
"base": "USD",
"rates": {
"2026-02-10": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-02-12": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-02-17": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

This response provides daily historical rates between two specified dates, enabling trend analysis over time.

Convert Endpoint

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

This example demonstrates how to convert an amount from one currency to another, providing the conversion rate and the resulting value.

Fluctuation Endpoint

{
"success": true,
"fluctuation": true,
"start_date": "2026-02-10",
"end_date": "2026-02-17",
"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"
}

This response provides insights into how rates fluctuate over a specified period, helping users understand market dynamics.

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

{
"success": true,
"timestamp": 1771287754,
"base": "USD",
"date": "2026-02-17",
"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"
}

This endpoint provides essential market data, including the opening, highest, lowest, and closing prices for a specific date, which is critical for traders.

Bid/Ask Endpoint

{
"success": true,
"timestamp": 1771287754,
"base": "USD",
"date": "2026-02-17",
"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"
}

This response provides the current bid and ask prices for metals, which is vital for traders looking to make quick decisions based on market conditions.

Conclusion

The Metals-API offers a powerful and flexible solution for developers seeking to access historical prices and real-time data for the Chinese Renminbi Yuan (CNY) and various metals. By leveraging the API's extensive features, developers can create applications that provide valuable insights into currency trends, market fluctuations, and investment opportunities.

As the financial landscape continues to evolve with technological advancements, the importance of accurate and timely data cannot be overstated. The Metals-API stands at the forefront of this transformation, enabling developers to harness the power of data analytics and smart technology integration.

For further exploration of the API's capabilities, visit the Metals-API Documentation and discover how you can implement these features in your applications. Stay informed about the latest supported symbols by checking the Metals-API Supported Symbols page. Embrace the future of financial data with the Metals-API and unlock new possibilities in your development projects.

Ready to use Metals-API?

Try it now!

Retrieve Chinese Renminbi Yuan (CNY) Historical Prices from this API