Get Cuban Convertible Peso (CUC) Historical Prices using this API

Metals-API 6 min read
Get Cuban Convertible Peso (CUC) Historical Prices using this API

Get Cuban Convertible Peso (CUC) Historical Prices using this API

The Cuban Convertible Peso (CUC) has been a significant currency in the context of Cuba's unique economic landscape. As the world increasingly embraces digital transformation, the demand for accurate and real-time financial data has surged. This is where the Metals-API comes into play, offering developers a powerful tool to access historical prices and real-time data for various currencies, including the CUC. In this blog post, we will explore the capabilities of Metals-API, focusing on how to retrieve historical prices for the CUC and the broader implications of such data in the digital age.

About Cuban Convertible Peso (CUC)

The Cuban Convertible Peso (CUC) was introduced in 1994 as part of Cuba's economic reforms. It was pegged to the US dollar, making it a crucial currency for tourists and foreign investors. However, the CUC has faced challenges due to Cuba's economic policies and the ongoing embargo. Understanding its historical prices is essential for investors, economists, and developers looking to create applications that analyze currency trends.

In the context of the digital transformation in metal markets, the CUC's historical data can provide insights into economic stability and market trends. The integration of smart technology and data analytics allows for a more profound understanding of currency fluctuations and their impact on the economy. As we look to the future, the potential for technological innovation in financial data access will continue to grow, making APIs like Metals-API invaluable.

API Description

The Metals-API is a robust platform designed to provide real-time and historical data for various metals and currencies. It empowers developers to build next-generation applications that require accurate financial data. The API's capabilities include:

  • Real-time Data Access: Developers can access up-to-date exchange rates for metals and currencies, allowing for timely decision-making.
  • Historical Data Retrieval: The API provides historical rates dating back to 2019, enabling users to analyze trends over time.
  • Comprehensive Endpoints: With multiple endpoints available, developers can retrieve specific data tailored to their needs, whether it's the latest rates, historical data, or conversion rates.

By leveraging the Metals-API, developers can create applications that not only track currency values but also analyze market trends, providing valuable insights into economic conditions.

Key Features and Endpoints

The Metals-API offers a variety of endpoints, each designed to fulfill specific data retrieval needs. Here are some of the key features:

  • Latest Rates Endpoint: Depending on your subscription plan, this endpoint returns real-time exchange rate data updated every 60 minutes, every 10 minutes, or even more frequently. This feature is crucial for applications that require the most current data to make informed decisions.
    • {
"success": true,
"timestamp": 1769213866,
"base": "USD",
"date": "2026-01-24",
"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: This endpoint allows users to access historical rates for most currencies dating back to 2019. By appending a specific date to the API call, developers can retrieve past exchange rates, which is essential for trend analysis.
    • {
"success": true,
"timestamp": 1769127466,
"base": "USD",
"date": "2026-01-23",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}
  • Bid And Ask Endpoint: This powerful feature enables users to retrieve real-time bid and ask prices for metals, providing a clear picture of market conditions.
    • {
"success": true,
"timestamp": 1769213866,
"base": "USD",
"date": "2026-01-24",
"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: This endpoint allows users to convert any amount from one currency to another. For example, converting USD to CUC can be done seamlessly, making it easier for developers to integrate currency conversion features into their applications.
    • {
"success": true,
"query": {
"from": "USD",
"to": "XAU",
"amount": 1000
},
"info": {
"timestamp": 1769213866,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}
  • Time-Series Endpoint: This endpoint allows users to query the API for daily historical rates between two dates of their choice. This feature is particularly useful for analyzing trends over specific periods.
    • {
"success": true,
"timeseries": true,
"start_date": "2026-01-17",
"end_date": "2026-01-24",
"base": "USD",
"rates": {
"2026-01-17": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-01-19": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-01-24": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}
  • Fluctuation Endpoint: This endpoint provides information about how currencies fluctuate on a day-to-day basis, allowing developers to track changes and analyze volatility.
    • {
"success": true,
"fluctuation": true,
"start_date": "2026-01-17",
"end_date": "2026-01-24",
"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: This endpoint allows users to query the API for the open, high, low, and close prices for a specific time period, providing a comprehensive view of market performance.
    • {
"success": true,
"timestamp": 1769213866,
"base": "USD",
"date": "2026-01-24",
"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: This endpoint provides access to historical rates for LME symbols dating back to 2008, allowing for a deeper analysis of metal prices over time.
  • API Key: Each user is assigned a unique API key that must be included in the API requests to authenticate and authorize access to the data.
  • API Response: The exchange rates delivered by the Metals-API are by default relative to USD, ensuring consistency across data retrieval.
  • Available Endpoints: The Metals-API offers a total of 14 endpoints, each providing different functionalities to cater to various data needs.
  • Supported Symbols Endpoint: This endpoint returns all available currencies, allowing developers to stay updated on the symbols they can use.
  • News Endpoint: The API also includes a news feature that retrieves the latest articles related to various metals, providing context and insights into market movements.

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

In conclusion, the Cuban Convertible Peso (CUC) represents a unique case in the world of currency, and accessing its historical prices is crucial for various stakeholders. The Metals-API offers a comprehensive solution for developers seeking to retrieve real-time and historical data for the CUC and other currencies. By leveraging the API's capabilities, developers can create applications that provide valuable insights into market trends, currency fluctuations, and economic conditions.

As we move towards a more data-driven future, the importance of APIs like Metals-API cannot be overstated. They not only facilitate access to critical financial data but also empower developers to innovate and create applications that can analyze and interpret this data effectively. For more information on how to get started with the Metals-API, check out the Metals-API Documentation for detailed guidance on implementation and usage.