Access Vadodara Gold 22k (VADO-22k) Exchange Rates API Documentation in JSON Format

In today's rapidly evolving financial landscape, the demand for real-time data on precious metals, particularly gold, has surged. Developers and businesses alike are leveraging APIs to access accurate exchange rates and market insights. One such powerful tool is the Metals-API, which provides comprehensive data on various metals, including gold (XAU), silver (XAG), platinum (XPT), and palladium (XPD). This blog post will delve into how to retrieve {Symbol} exchange rates in JSON format using the Metals-API, complete with sample API responses and integration tips.

About Gold (XAU)

Gold has long been a symbol of wealth and stability, making it a crucial asset in financial markets. The digital transformation in precious metals trading has opened new avenues for data analytics and market insights. With the integration of technology in trading, developers can harness real-time data to innovate price discovery and enhance trading strategies. The Metals-API empowers developers to build next-generation applications that can analyze trends, track fluctuations, and provide insights into gold's market behavior.

API Description

The Metals-API is designed to provide developers with real-time and historical data on precious metals. Its capabilities include:

Real-time Exchange Rates: Access the latest rates for various metals, updated frequently based on your subscription plan.
Historical Data: Retrieve historical exchange rates dating back to 2019, allowing for comprehensive market analysis.
Bid and Ask Prices: Get real-time bid and ask prices to make informed trading decisions.
Currency Conversion: Convert amounts between different metals or to/from USD seamlessly.
Time-Series Data: Analyze daily historical rates over a specified period.
Fluctuation Tracking: Monitor how metal prices fluctuate over time.
Carat Information: Access gold rates by carat for precise valuation.
Open/High/Low/Close (OHLC) Data: Get detailed price information for specific time periods.
News Updates: Stay informed with the latest news articles related to various metals.

For more detailed information, refer to the Metals-API Documentation.

Key Features and Endpoints

The Metals-API offers a variety of endpoints, each serving a unique purpose. Here are some of the key features:

Latest Rates Endpoint

The Latest Rates Endpoint provides real-time exchange rate data for all available metals. Depending on your subscription plan, the API updates this data every 60 minutes, every 10 minutes, or even more frequently. This endpoint is essential for applications that require up-to-the-minute pricing information.

{
"success": true,
"timestamp": 1766368828,
"base": "USD",
"date": "2025-12-22",
"rates": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"XPD": 0.000744
},
"unit": "per troy ounce"
}

In this response, the rates object contains the exchange rates for various metals relative to USD, with XAU representing gold.

Historical Rates Endpoint

Accessing historical rates is crucial for market analysis and trend forecasting. The Historical Rates Endpoint allows you to query rates for any date since 1999.

{
"success": true,
"timestamp": 1766282428,
"base": "USD",
"date": "2025-12-21",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"unit": "per troy ounce"
}

This response provides historical data, which can be invaluable for understanding market trends over time.

Time-Series Endpoint

The Time-Series Endpoint allows developers to retrieve exchange rates for a specific time period. This is particularly useful for analyzing trends and fluctuations over time.

{
"success": true,
"timeseries": true,
"start_date": "2025-12-15",
"end_date": "2025-12-22",
"base": "USD",
"rates": {
"2025-12-15": {
"XAU": 0.000485,
"XAG": 0.03825
},
"2025-12-22": {
"XAU": 0.000482,
"XAG": 0.03815
}
},
"unit": "per troy ounce"
}

This endpoint provides a comprehensive view of how rates have changed over the specified period, allowing for detailed analysis.

Convert Endpoint

The Convert Endpoint is a powerful feature that enables users to convert any amount from one metal to another or to/from USD. This functionality is essential for applications that require real-time conversion capabilities.

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

In this example, the API converts 1000 USD to its equivalent in gold (XAU), providing both the conversion rate and the result.

Fluctuation Endpoint

The Fluctuation Endpoint allows users to track rate fluctuations between two dates. This is particularly useful for traders looking to understand market volatility.

{
"success": true,
"fluctuation": true,
"start_date": "2025-12-15",
"end_date": "2025-12-22",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482,
"change": -3.0e-6,
"change_pct": -0.62
}
},
"unit": "per troy ounce"
}

This response provides insights into how gold prices have changed over the specified period, including the percentage change.

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

The OHLC Price Endpoint provides detailed price information for a specific time period, including the opening, highest, lowest, and closing prices.

{
"success": true,
"timestamp": 1766368828,
"base": "USD",
"date": "2025-12-22",
"rates": {
"XAU": {
"open": 0.000485,
"high": 0.000487,
"low": 0.000481,
"close": 0.000482
}
},
"unit": "per troy ounce"
}

This endpoint is crucial for traders who need to analyze price movements and make informed decisions based on historical performance.

Bid/Ask Endpoint

The Bid/Ask Endpoint provides current bid and ask prices for metals, which is essential for traders looking to execute orders at the best possible prices.

{
"success": true,
"timestamp": 1766368828,
"base": "USD",
"date": "2025-12-22",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
}
},
"unit": "per troy ounce"
}

This response provides the bid and ask prices for gold, along with the spread, which is critical for understanding market liquidity.

Integration Tips

Integrating the Metals-API into your applications can significantly enhance your ability to analyze and trade precious metals. Here are some tips for successful integration:

Authentication: Ensure you have your unique API key, which is required for all requests. This key should be included in the access_key parameter of your API calls.
Rate Limiting: Be aware of your subscription plan's rate limits to avoid exceeding your quota. Implement error handling to manage rate limit errors gracefully.
Data Caching: To optimize performance, consider caching frequently accessed data, especially for endpoints that do not change often.
Error Handling: Implement robust error handling to manage various response scenarios, including success, error, and empty results.
Security Best Practices: Always use HTTPS for API requests to ensure data security. Additionally, avoid exposing your API key in client-side code.

Conclusion

The Metals-API is a powerful tool for developers looking to access real-time and historical data on precious metals, particularly gold. By leveraging its various endpoints, you can build applications that provide valuable insights into market trends, facilitate trading, and enhance decision-making processes. Whether you are interested in the latest rates, historical data, or bid/ask prices, the Metals-API offers comprehensive solutions to meet your needs.

For more information, explore the Metals-API Supported Symbols and dive deeper into the Metals-API Documentation for detailed guidance on implementation and usage. Embrace the digital transformation in precious metals trading and unlock the potential of real-time data with the Metals-API.

Ready to use Metals-API?

Try it now!

Access Vadodara Gold 22k (VADO-22k) Exchange Rates API Documentation in JSON Format