How to retrieve Nigerian Naira (NGN) prices using this API

How to Retrieve Nigerian Naira (NGN) Prices Using the Metals-API

In today's fast-paced financial landscape, the ability to access real-time data is crucial for developers and businesses alike. This is especially true in the metals market, where fluctuations can significantly impact investment strategies. The Metals-API provides a robust solution for retrieving prices of various metals, including the Nigerian Naira (NGN). This blog post will delve into the capabilities of the Metals-API, focusing on its features, endpoints, and how developers can leverage this powerful tool to enhance their applications.

Metals-API Information

About Nickel (NI)

Nickel, represented by the symbol NI, is a key player in the metals market, particularly in the production of stainless steel and other alloys. As industries evolve, the demand for nickel continues to rise, driven by technological advancements and digital transformation in metal markets. The integration of smart technologies and data analytics has revolutionized how businesses operate, allowing for real-time insights and informed decision-making.

With the rise of electric vehicles and renewable energy technologies, nickel is poised to play a pivotal role in future trends. The Metals-API empowers developers to tap into this potential by providing access to real-time data, enabling them to build applications that can respond to market changes swiftly and effectively.

API Description

The Metals-API is a powerful tool designed to provide developers with real-time and historical data on metal prices. This API is particularly beneficial for applications that require up-to-date information on market trends, allowing businesses to make informed decisions based on accurate data. The API's capabilities include retrieving the latest rates, historical data, and even fluctuations over specified periods.

One of the standout features of the Metals-API is its ability to deliver data in a user-friendly JSON format. This makes it easy for developers to integrate the API into their applications, ensuring that they can access the information they need without unnecessary complexity. The API supports a wide range of endpoints, each designed to cater to specific data retrieval needs.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that provide different functionalities, allowing developers to customize their data retrieval processes. Here are some of the key features:

• Latest Rates Endpoint: This endpoint provides real-time exchange rate data, updated every 60 minutes, 10 minutes, or even more frequently, depending on the subscription plan. For example, a request to the latest rates endpoint might return the following JSON response:

{
"success": true,
"timestamp": 1772496600,
"base": "USD",
"date": "2026-03-03",
"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 dating back to 2019. By appending a specific date to the request, developers can retrieve past data, which is essential for trend analysis. An example response might look like this:

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

• Bid and Ask Endpoint: This feature enables developers to retrieve real-time bid and ask prices for metals, which is crucial for trading applications. A typical response might include:

{
"success": true,
"timestamp": 1772496600,
"base": "USD",
"date": "2026-03-03",
"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 for easy conversion between different metals or from/to USD. For instance, converting 1000 USD to Gold might yield:

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

• Time-Series Endpoint: This feature allows users to query daily historical rates between two specified dates, which is invaluable for analyzing trends over time. An example response could look like this:

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

• Fluctuation Endpoint: This endpoint provides insights into how metal prices fluctuate over a specified period. For example:

{
"success": true,
"fluctuation": true,
"start_date": "2026-02-24",
"end_date": "2026-03-03",
"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 provides comprehensive data on the open, high, low, and close prices for a specific time period, which is essential for traders. An example response might be:

{
"success": true,
"timestamp": 1772496600,
"base": "USD",
"date": "2026-03-03",
"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 extensive market analysis.
• API Key: The API requires an API key for authentication, which must be included in the request URL to access the data.
• API Response: The API returns exchange rates relative to USD by default, ensuring consistency across data retrieval.
• Supported Symbols Endpoint: This endpoint provides a constantly updated list of all available currencies and metals, which can be accessed at any time.
• News Endpoint: The API also includes a news endpoint that retrieves the latest articles related to various metals, keeping developers informed about market trends.

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.

Conclusion

The Metals-API is an invaluable resource for developers looking to integrate real-time metal price data into their applications. With its extensive range of features and endpoints, the API empowers users to make informed decisions based on accurate and timely information. By leveraging the capabilities of the Metals-API, developers can create innovative applications that respond to market changes and provide users with the insights they need.

For more detailed information on how to implement the API, refer to the Metals-API Documentation. This resource provides comprehensive guidance on utilizing the API's features effectively. As the metals market continues to evolve, staying informed and adaptable will be key to success in this dynamic field.