How to get Jordanian Dinar (JOD) prices using this API

Introduction

The Jordanian Dinar (JOD) is a vital currency in the Middle Eastern financial landscape, and understanding its pricing dynamics is essential for traders, investors, and developers alike. In this blog post, we will explore how to get Jordanian Dinar prices using the Metals-API, a powerful tool that provides real-time data on various metals and currencies. We will delve into the capabilities of this API, focusing on its innovative features and how it can transform the way developers interact with financial data.

Understanding the Jordanian Dinar and Its Markets

The Jordanian Dinar is the official currency of Jordan, and it plays a crucial role in the region's economy. The currency is pegged to the US dollar, which provides a level of stability in exchange rates. However, fluctuations can occur due to various factors, including geopolitical events, economic indicators, and market sentiment. By utilizing the Metals-API, developers can access real-time data on the JOD and other currencies, enabling them to build applications that provide insights into market trends and pricing.

About Nickel (NI)

Nickel, represented by the symbol NI, is a key metal in various industries, including electronics, automotive, and construction. The digital transformation in metal markets has led to significant advancements in how nickel prices are tracked and analyzed. With the integration of smart technology and data analytics, stakeholders can gain deeper insights into market movements.

Technological innovations have enabled real-time tracking of nickel prices, allowing traders to make informed decisions quickly. The Metals-API plays a pivotal role in this transformation by providing developers with access to comprehensive data on nickel and other metals. This API empowers users to build applications that leverage data analytics to forecast price trends and analyze market behavior.

API Description

The Metals-API is a robust platform that offers real-time and historical data on metal prices and currency conversions. It is designed for developers looking to integrate financial data into their applications seamlessly. The API provides a wide range of endpoints, each serving a specific purpose, from retrieving the latest rates to accessing historical data.

One of the standout features of the Metals-API is its ability to deliver real-time data, which is crucial for applications that require up-to-the-minute information. This capability is particularly beneficial for traders and financial analysts who need to react quickly to market changes. The API's innovative design allows for easy integration, making it a go-to resource for developers in the financial sector.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different data needs:

• Latest Rates Endpoint: This endpoint provides real-time exchange rate data for various metals and currencies. Depending on your subscription plan, the API can return updates every 60 minutes or even every 10 minutes. This feature is essential for applications that require the most current pricing information.
• Historical Rates Endpoint: Users can access historical rates dating back to 2019. By appending a specific date to the API request, developers can retrieve past pricing data, which is invaluable for trend analysis and forecasting.
• Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices for metals. It is particularly useful for traders who need to understand market spreads and make informed buying or selling decisions.
• Convert Endpoint: The conversion endpoint enables users to convert amounts between different currencies or metals. This functionality is crucial for applications that require currency conversion for transactions or reporting.
• Time-Series Endpoint: Developers can query the API for daily historical rates between two specified dates. This feature is beneficial for analyzing price trends over time.
• Fluctuation Endpoint: This endpoint provides information on how currencies fluctuate on a day-to-day basis, allowing users to track volatility and make informed decisions.
• Carat Endpoint: Users can retrieve gold rates by carat, which is essential for jewelers and gold traders who need precise pricing information.
• Lowest/Highest Price Endpoint: This feature allows users to query the API for the lowest and highest prices of metals over a specified period, aiding in market analysis.
• Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific time period, which is crucial for technical analysis.
• Historical LME Endpoint: Users can access historical rates for LME symbols dating back to 2008, providing a comprehensive view of market trends.
• 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 API delivers exchange rates relative to USD by default, ensuring consistency in data interpretation.
• Available Endpoints: The Metals-API features 14 different endpoints, each designed to provide specific functionalities.
• Supported Symbols Endpoint: This endpoint returns a constantly updated list of all available currencies and metals, ensuring users have access to the latest data.
• News Endpoint: Users can retrieve the latest news articles related to various metals, keeping them informed about market developments.

API Endpoint Examples and Responses

Latest Rates Endpoint

The Latest Rates Endpoint allows users to get real-time exchange rates for all available metals. Here’s an example response:

{
"success": true,
"timestamp": 1769645544,
"base": "USD",
"date": "2026-01-29",
"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"
}

In this response, the "rates" object contains the current prices of various metals relative to USD, which is crucial for traders looking to make quick decisions based on the latest market data.

Historical Rates Endpoint

The Historical Rates Endpoint allows users to access historical exchange rates for any date since 1999. Here’s an example response:

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

This response provides historical pricing data, which can be used for trend analysis and forecasting future price movements.

Time-Series Endpoint

The Time-Series Endpoint allows users to get exchange rates for a specific time period. Here’s an example response:

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

This endpoint is particularly useful for analyzing price trends over a specified period, allowing developers to build applications that visualize historical data effectively.

Convert Endpoint

The Convert Endpoint enables users 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": 1769645544,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

This response shows how much 1000 USD is worth in gold (XAU), providing essential information for users engaged in currency conversion.

Fluctuation Endpoint

The Fluctuation Endpoint allows users to track rate fluctuations between two dates. Here’s an example response:

{
"success": true,
"fluctuation": true,
"start_date": "2026-01-22",
"end_date": "2026-01-29",
"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 provides valuable insights into market volatility, helping traders make informed decisions based on historical price changes.

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

The OHLC Price Endpoint provides open, high, low, and close prices for a specific time period. Here’s an example response:

{
"success": true,
"timestamp": 1769645544,
"base": "USD",
"date": "2026-01-29",
"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 data is crucial for technical analysis, allowing traders to assess market trends and make predictions based on historical performance.

Bid/Ask Endpoint

The Bid/Ask Endpoint provides current bid and ask prices for metals. Here’s an example response:

{
"success": true,
"timestamp": 1769645544,
"base": "USD",
"date": "2026-01-29",
"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 is essential for traders looking to understand market spreads and make informed trading decisions based on current market conditions.

Conclusion

The Metals-API is an invaluable resource for developers looking to access real-time and historical data on the Jordanian Dinar and other currencies. By leveraging its extensive features, such as the Latest Rates, Historical Rates, and Bid/Ask endpoints, developers can create applications that provide users with actionable insights into market trends and pricing dynamics.

As the financial landscape continues to evolve, the integration of advanced technologies and data analytics will play a crucial role in shaping the future of trading and investment. The Metals-API stands at the forefront of this transformation, empowering developers to build next-generation applications that harness the power of real-time metals data.

For more information on how to get started with the Metals-API, visit the Metals-API Documentation and explore the Metals-API Supported Symbols page for a comprehensive list of available currencies and metals.