How to Use this API to Get Farid
How to Use this API to Get Historical Prices with Metals-API
In today's fast-paced financial landscape, having access to real-time data is crucial for developers and businesses alike. The Metals-API provides a powerful solution for obtaining historical prices and real-time data for various metals, including Gold (XAU), Silver (XAG), Platinum (XPT), and Palladium (XPD). This blog post will delve into the capabilities of the Metals-API, focusing on how to effectively use it to retrieve historical prices and other valuable data.
Metals-API Information
The Metals-API is a comprehensive JSON API that allows developers to access a wealth of information regarding metal prices and currency conversions. With its innovative design and robust features, the API empowers developers to build next-generation applications that can leverage real-time metals data for various use cases, including financial analysis, investment tracking, and market research.
For more detailed information, you can refer to the Metals-API Documentation, which provides extensive guidance on how to implement and utilize the API effectively.
Key Features and Endpoints
The Metals-API offers 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 for metals, updated based on your subscription plan. Depending on your plan, you can receive updates every 60 minutes, every 10 minutes, or even more frequently.
- Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. You can query the API for historical rates by appending a specific date to the endpoint.
- Bid and Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing for precise trading and investment decisions.
- Convert Endpoint: This feature 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, enabling detailed analysis over time.
- Fluctuation Endpoint: Track how metal prices fluctuate on a day-to-day basis, providing insights into market trends.
- Carat Endpoint: Retrieve information about Gold rates by carat, which is essential for jewelers and gold traders.
- Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date.
- Open/High/Low/Close (OHLC) Price Endpoint: Get open, high, low, and close prices for a specific date, 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: The API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format.
- Available Endpoints: The API features 14 endpoints, each offering different functionalities to meet diverse user needs.
- Supported Symbols Endpoint: This endpoint returns all available currencies, ensuring you have the latest information on supported symbols.
- News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about 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 Metals-API Supported Symbols page.
API Endpoint Examples and Responses
Understanding how to interpret API responses is crucial for effective implementation. Below are examples of responses from various endpoints:
Latest Rates Endpoint
Get real-time exchange rates for all available metals:
{
"success": true,
"timestamp": 1769214086,
"base": "USD",
"date": "2026-01-24",
"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": 1769127686,
"base": "USD",
"date": "2026-01-23",
"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-01-17",
"end_date": "2026-01-24",
"base": "USD",
"rates": {
"2026-01-17": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-01-19": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-01-24": {
"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": 1769214086,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}
Fluctuation Endpoint
Track rate fluctuations between two dates:
{
"success": true,
"fluctuation": true,
"start_date": "2026-01-17",
"end_date": "2026-01-24",
"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": 1769214086,
"base": "USD",
"date": "2026-01-24",
"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": 1769214086,
"base": "USD",
"date": "2026-01-24",
"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
The Metals-API is a powerful tool for developers looking to integrate real-time and historical metals data into their applications. With its extensive range of endpoints, including the latest rates, historical rates, and conversion capabilities, the API provides a comprehensive solution for financial analysis and market research. By leveraging the capabilities of the Metals-API, developers can create innovative applications that respond to market changes in real-time, enabling users to make informed decisions based on accurate data.
For further exploration of the API's capabilities, visit the Metals-API Documentation for detailed implementation guidance, and check out the Metals-API Supported Symbols page to understand the full range of available metal symbols.
By utilizing the Metals-API, you can unlock the potential of real-time metals data and transform your applications into powerful tools for financial analysis and decision-making.