Access Salvadoran Coln (SVC) Exchange Rate API Documentation in JSON Format
Access Salvadoran Colón (SVC) Exchange Rate API Documentation in JSON Format
In today's rapidly evolving financial landscape, the ability to access real-time exchange rates for metals is crucial for developers and businesses alike. The Metals-API provides a robust solution for retrieving exchange rates in JSON format, including the Salvadoran Colón (SVC). This blog post will guide you through the process of retrieving exchange rates for various metals, including Gold (XAU), Silver (XAG), Platinum (XPT), and Palladium (XPD), using the Metals-API. We will explore the API's capabilities, provide sample API responses, and offer integration tips to help you leverage this powerful tool effectively.
Understanding Metals-API
The Metals-API is a comprehensive JSON API that provides access to real-time and historical exchange rates for various metals. It empowers developers to build next-generation applications by offering a suite of endpoints that deliver valuable data analytics and insights. With the Metals-API, you can easily integrate real-time metals data into your applications, enabling informed decision-making and strategic planning.
Key Features of Metals-API
The Metals-API boasts a variety of endpoints, each designed to cater to specific needs. 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 more frequently, depending on your subscription plan. It allows you to retrieve the latest rates for metals in relation to a base currency, typically USD.
- Historical Rates Endpoint: Access historical exchange rates dating back to 2019. You can query the API for historical rates by appending a specific date (YYYY-MM-DD) to the endpoint.
- Bid and Ask Endpoint: Retrieve real-time bid and ask prices for metals, which is essential for traders and financial analysts.
- Convert Endpoint: This endpoint allows you to convert any amount from one metal to another or to/from USD, facilitating seamless transactions.
- Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, providing insights into trends over time.
- Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, which is vital for understanding market dynamics.
- Carat Endpoint: Retrieve information about Gold rates by Carat, which is particularly useful for jewelers and gold traders.
- Lowest/Highest Price Endpoint: Get the lowest and highest prices for metals over a specified period, aiding in market analysis.
- Open/High/Low/Close (OHLC) Price Endpoint: Access OHLC data for a specific time period, which is crucial for technical analysis.
- Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a long-term view of market trends.
- API Key: Your unique API key is required to access the API, ensuring secure and authorized usage.
- API Response: Exchange rates are delivered relative to USD by default, with all 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.
Sample API Responses
To illustrate the capabilities of the Metals-API, let's explore some sample API responses for various endpoints.
Latest Rates Endpoint
{
"success": true,
"timestamp": 1774148855,
"base": "USD",
"date": "2026-03-22",
"rates": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"XPD": 0.000744
},
"unit": "per troy ounce"
}
This response indicates that the latest exchange rates for Gold (XAU), Silver (XAG), Platinum (XPT), and Palladium (XPD) are provided in relation to USD.
Historical Rates Endpoint
{
"success": true,
"timestamp": 1774062455,
"base": "USD",
"date": "2026-03-21",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}
This response shows historical exchange rates for a specific date, allowing users to analyze past market behavior.
Time-Series Endpoint
{
"success": true,
"timeseries": true,
"start_date": "2026-03-15",
"end_date": "2026-03-22",
"base": "USD",
"rates": {
"2026-03-15": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-03-17": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-03-22": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}
This response provides a time-series view of exchange rates, enabling users to track trends over a specified period.
Convert Endpoint
{
"success": true,
"query": {
"from": "USD",
"to": "XAU",
"amount": 1000
},
"info": {
"timestamp": 1774148855,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}
This response demonstrates how to convert an amount from USD to Gold (XAU), providing the equivalent value in troy ounces.
Fluctuation Endpoint
{
"success": true,
"fluctuation": true,
"start_date": "2026-03-15",
"end_date": "2026-03-22",
"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 response provides insights into how the rates for various metals have fluctuated over a specified period, which is essential for traders and analysts.
Open/High/Low/Close (OHLC) Price Endpoint
{
"success": true,
"timestamp": 1774148855,
"base": "USD",
"date": "2026-03-22",
"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 response provides OHLC data for metals, which is crucial for technical analysis and understanding market trends.
Bid/Ask Endpoint
{
"success": true,
"timestamp": 1774148855,
"base": "USD",
"date": "2026-03-22",
"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 response provides the current bid and ask prices for metals, which is essential for traders looking to make informed decisions.
Integration Tips
Integrating the Metals-API into your applications can significantly enhance your data analytics capabilities. Here are some practical tips for successful integration:
- Authentication: Ensure you securely store your API key and include it in your requests to authenticate your access to the API.
- Rate Limiting: Be mindful of your subscription plan's rate limits to avoid exceeding your quota. Implement error handling to gracefully manage rate limit errors.
- Data Caching: Consider caching responses for frequently accessed data to improve performance and reduce API calls.
- Error Handling: Implement robust error handling to manage potential issues, such as network errors or invalid requests. This will enhance the user experience.
- Data Validation: Validate incoming data to ensure it meets your application's requirements and prevent potential issues.
- Performance Optimization: Optimize your API calls by requesting only the data you need. Use filtering options where available to minimize response sizes.
Conclusion
The Metals-API is a powerful tool for developers looking to access real-time and historical exchange rates for metals, including the Salvadoran Colón (SVC). With its comprehensive suite of endpoints, the API enables seamless integration of valuable data into applications, empowering users to make informed decisions based on real-time insights. By leveraging the API's capabilities, developers can build innovative applications that enhance data analytics and drive strategic planning.
For more information on how to get started, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols for a complete list of available metals. Embrace the future of financial data with the Metals-API and unlock the potential of real-time metals data in your applications.