Access Salem Gold 22k (SALE-22k) API Integration Guide for Exchange Rates in JSON Format

Access Salem Gold 22k (SALE-22k) API Integration Guide for Exchange Rates in JSON Format

In the ever-evolving landscape of financial technology, the ability to access real-time data is paramount for developers working with precious metals, particularly gold (XAU). The Metals-API provides a robust solution for retrieving exchange rates in JSON format, enabling developers to integrate this data seamlessly into their applications. This guide will delve into the capabilities of the Metals-API, focusing on how to effectively retrieve gold exchange rates and leverage the API's features for innovative applications.

Metals-API Information

About Gold (XAU)

Gold has long been a symbol of wealth and stability, and its significance in the financial markets continues to grow. As digital transformation reshapes the landscape of precious metals trading, the integration of data analytics and market insights becomes essential. The Metals-API empowers developers to harness real-time data, facilitating technology integration in trading and innovation in price discovery. By utilizing digital asset solutions, developers can create applications that not only track gold prices but also analyze market trends and fluctuations.

API Description

The Metals-API is a powerful tool designed to provide developers with access to real-time and historical metals data. With its innovative capabilities, the API enables the creation of next-generation applications that can respond to market changes instantly. The API supports a variety of endpoints, each tailored to meet specific data retrieval needs, from the latest exchange rates to historical trends. For comprehensive details, developers can refer to the Metals-API Documentation.

For those interested in the range of metals available, the Metals-API Supported Symbols page provides a complete list of all supported symbols and their specifications. The main website, Metals-API Website, serves as a hub for accessing additional resources and tools.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different data needs. Each endpoint is designed to provide specific functionalities that can be leveraged for various applications. Below are some of the key features and their potential applications:

• Latest Rates Endpoint: This endpoint provides real-time exchange rate data, updated based on your subscription plan. Developers can access the latest rates for gold and other metals, allowing for timely decision-making in trading applications.
• Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your query. This feature is invaluable for developers looking to analyze trends over time and make informed predictions.
• Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, which is crucial for traders looking to execute orders at optimal prices.
• Convert Endpoint: This endpoint allows for currency conversion between metals and fiat currencies, enabling applications that require dynamic pricing models.
• Time-Series Endpoint: Query daily historical rates between two dates, providing insights into price movements over specified periods.
• Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, which is essential for risk management and strategy development.
• Carat Endpoint: Retrieve information about gold rates by carat, which is particularly useful for jewelers and retailers.
• Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date, aiding in market analysis.
• Open/High/Low/Close (OHLC) Price Endpoint: Access open, high, low, and close prices for a specific time period, which is critical for technical analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a wealth of data for comprehensive analysis.
• API Key: Your unique API key is essential for accessing the API and must be included in your requests.
• API Response: The API delivers exchange rates relative to USD, ensuring consistency in data interpretation.
• Available Endpoints: With 14 API endpoints, developers have access to a wide range of functionalities tailored to their needs.
• Supported Symbols Endpoint: This endpoint returns all available currencies, ensuring developers can access the latest symbols.
• News Endpoint: Retrieve the latest news articles related to various metals, keeping your application informed of market 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 Symbols page. This resource is essential for developers looking to integrate specific metals into their applications.

API Endpoint Examples and Responses

Understanding how to interact with the Metals-API is crucial for effective integration. Below are examples of API responses for various endpoints, showcasing the structure and data provided.

Latest Rates Endpoint

Get real-time exchange rates for all available metals.

{
"success": true,
"timestamp": 1778663300,
"base": "USD",
"date": "2026-05-13",
"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

Access historical exchange rates for any date since 1999.

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

Time-series Endpoint

Get exchange rates for a specific time period.

{
"success": true,
"timeseries": true,
"start_date": "2026-05-06",
"end_date": "2026-05-13",
"base": "USD",
"rates": {
"2026-05-06": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-05-08": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-05-13": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

Convert Endpoint

Convert any amount from one metal to another or to/from USD.

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

Fluctuation Endpoint

Track rate fluctuations between two dates.

{
"success": true,
"fluctuation": true,
"start_date": "2026-05-06",
"end_date": "2026-05-13",
"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"
}

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period.

{
"success": true,
"timestamp": 1778663300,
"base": "USD",
"date": "2026-05-13",
"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"
}

Bid/Ask Endpoint

Get current bid and ask prices for metals.

{
"success": true,
"timestamp": 1778663300,
"base": "USD",
"date": "2026-05-13",
"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"
}

Conclusion

Integrating the Metals-API into your applications provides a powerful means of accessing real-time and historical gold exchange rates. By leveraging the various endpoints, developers can create sophisticated applications that not only track prices but also analyze market trends and fluctuations. The API's capabilities, including the latest rates, historical data, and conversion features, empower developers to build innovative solutions in the precious metals market.

For further exploration, developers are encouraged to review the Metals-API Documentation for detailed information on each endpoint and its functionalities. Additionally, the Metals-API Supported Symbols page is an invaluable resource for understanding the available metal symbols. Finally, the Metals-API Website serves as a central hub for accessing tools and resources that can enhance your development experience.