Access Ghanaian Cedi (GHS) Exchange Rates API Documentation in JSON Format

In today's rapidly evolving digital landscape, the demand for real-time financial data is more critical than ever. Developers looking to integrate exchange rates into their applications can leverage the Metals-API, a powerful tool that provides access to a wide range of metal exchange rates, including the Ghanaian Cedi (GHS). This blog post will guide you through retrieving GHS exchange rates in JSON format, showcasing sample API responses and offering integration tips to help you maximize the potential of this innovative API.

Metals-API Overview

The Metals-API is designed to provide developers with real-time and historical data on metal prices and currency exchange rates. With a focus on technological advancement and digital transformation in the metal markets, this API empowers developers to build next-generation applications that require accurate and timely financial data. The API supports various endpoints, each tailored to specific functionalities, allowing for comprehensive data retrieval and analysis.

Key Features of Metals-API

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

Latest Rates Endpoint: Retrieve real-time exchange rate data updated every 60 minutes, 10 minutes, or even more frequently, depending on your subscription plan. This endpoint is essential for applications that require up-to-the-minute pricing information.
Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your query. This feature is invaluable for analyzing trends over time.
Bid and Ask Endpoint: Get real-time bid and ask prices for various metals, allowing for precise trading decisions.
Convert Endpoint: Easily convert amounts between different currencies or metals, facilitating seamless transactions.
Time-Series Endpoint: Query daily historical rates between two dates, enabling detailed analysis of price movements.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, providing insights into market volatility.
Carat Endpoint: Retrieve gold rates by carat, which is particularly useful for jewelers and gold traders.
Lowest/Highest Price Endpoint: Get the lowest and highest prices for a specified date, helping you identify market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Access OHLC data for a specific time period, crucial for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, useful for those involved in the London Metal Exchange.
API Key: Secure access to the API is managed through a unique API key, ensuring that only authorized users can retrieve data.
API Response: All exchange rates are delivered relative to USD, with data returned in a structured JSON format.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market developments.

Understanding API Responses

When you make a request to the Metals-API, the response is delivered in JSON format, which is both human-readable and easy to parse programmatically. Below are examples of API responses for various endpoints, along with explanations of the fields included in each response.

Latest Rates Endpoint

{
"success": true,
"timestamp": 1773015817,
"base": "USD",
"date": "2026-03-09",
"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"
}

The response indicates whether the request was successful, provides a timestamp of the data retrieval, and lists the exchange rates for various metals relative to USD. The "rates" object contains the metal symbols as keys and their corresponding values, which represent the price per troy ounce.

Historical Rates Endpoint

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

This response provides historical exchange rates for a specified date. The "rates" object contains the same structure as the latest rates, allowing for easy comparison and analysis.

Time-Series Endpoint

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

This response provides a time series of exchange rates between two specified dates. Each date is a key in the "rates" object, with the corresponding values for each metal.

Convert Endpoint

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

The Convert Endpoint allows you to convert a specified amount from one currency to another. The response includes the original query, the conversion rate, and the result of the conversion.

Fluctuation Endpoint

{
"success": true,
"fluctuation": true,
"start_date": "2026-03-02",
"end_date": "2026-03-09",
"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 endpoint tracks fluctuations in exchange rates over a specified period. The response details the starting and ending rates, the change in value, and the percentage change, providing insights into market trends.

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

{
"success": true,
"timestamp": 1773015817,
"base": "USD",
"date": "2026-03-09",
"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"
}

The OHLC endpoint provides essential data for traders and analysts, detailing the opening, highest, lowest, and closing prices for a specified date.

Bid/Ask Endpoint

{
"success": true,
"timestamp": 1773015817,
"base": "USD",
"date": "2026-03-09",
"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 endpoint provides the current bid and ask prices for metals, along with the spread, which is crucial for traders looking to make informed decisions.

Integration Tips

Integrating the Metals-API into your application can significantly enhance its functionality. Here are some tips to ensure a smooth integration process:

Authentication: Always secure your API key and include it in your requests to authenticate access. This key is essential for all API interactions.
Rate Limiting: Be mindful of the API's rate limits based on your subscription plan. Implement caching strategies to minimize unnecessary requests and optimize performance.
Error Handling: Implement robust error handling to manage potential issues such as network failures or invalid requests. This will enhance user experience and application reliability.
Data Validation: Ensure that all data received from the API is validated and sanitized before use in your application to prevent security vulnerabilities.
Performance Optimization: Consider using asynchronous requests to improve the responsiveness of your application when retrieving data from the API.

Conclusion

The Metals-API is a powerful resource for developers seeking to integrate real-time and historical exchange rates into their applications. By leveraging its comprehensive endpoints, including the latest rates, historical data, and conversion capabilities, developers can create innovative solutions that meet the demands of today's financial landscape. With a focus on technological advancement and data analytics, the Metals-API empowers users to gain valuable insights into market trends and fluctuations.

For more information on how to get started, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols to find the metal symbols you need for your application. Embrace the future of financial data integration with the Metals-API and unlock new possibilities for your projects.

Ready to use Metals-API?

Try it now!

Access Ghanaian Cedi (GHS) Exchange Rates API Documentation in JSON Format