Retrieve São Tomé and Príncipe Dobra (STD) Historical Prices API Documentation

Introduction

In the world of finance and trading, having access to accurate and timely data is crucial. For developers looking to integrate historical price data for metals, the Metals-API offers a robust solution. This blog post will explore how to retrieve historical prices for the São Tomé and Príncipe Dobra (STD) using the Metals-API. We will delve into the API's capabilities, its endpoints, and how it can empower developers to create innovative applications that leverage real-time and historical metals data.

Understanding Neodymium (ND) and Its Market Impact

Neodymium, a rare earth metal, plays a significant role in various industries, particularly in the production of strong permanent magnets used in electric vehicles, wind turbines, and consumer electronics. As the demand for green technologies increases, the market for neodymium is expected to grow, driven by digital transformation and technological advancements. The integration of smart technology and data analytics in metal markets allows for better insights into pricing trends and market fluctuations.

With the rise of data-driven decision-making, developers can harness the power of the Metals-API to gain insights into neodymium pricing and trends. This API not only provides real-time data but also historical data that can be analyzed to predict future market movements. By utilizing advanced data analytics, developers can create applications that offer valuable insights into the neodymium market, helping businesses make informed decisions.

API Description

The Metals-API is designed to provide developers with access to real-time and historical metals data, enabling the creation of next-generation applications. This API is a powerful tool for accessing exchange rates for various metals, including neodymium, and allows for seamless integration into existing systems. The API's capabilities include retrieving the latest rates, historical prices, and conversion functionalities, making it an essential resource for developers in the financial sector.

For more information, you can visit the Metals-API Website or check out the Metals-API Documentation for detailed instructions on how to implement the API in your projects.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs. Each endpoint provides unique functionalities that can be leveraged for various applications. Here’s a detailed look at some of the key features:

Latest Rates Endpoint

The Latest Rates Endpoint allows developers to retrieve real-time exchange rate data for metals. Depending on the subscription plan, this endpoint can return data updated every 60 minutes or every 10 minutes. This feature is particularly useful for applications that require up-to-the-minute pricing information.

{
"success": true,
"timestamp": 1788826317,
"base": "USD",
"date": "2026-09-08",
"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

The Historical Rates Endpoint provides access to historical exchange rates for most currencies dating back to 2019. Developers can query the Metals-API for historical rates by appending a specific date in the format YYYY-MM-DD. This feature is essential for analyzing trends over time and making informed predictions about future prices.

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

Bid And Ask Endpoint

The Bid and Ask Endpoint is a powerful feature that enables developers to retrieve real-time bid and ask prices for metals. This information is crucial for traders who need to make quick decisions based on current market conditions.

{
"success": true,
"timestamp": 1788826317,
"base": "USD",
"date": "2026-09-08",
"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"
}

Convert Endpoint

The Convert Endpoint allows users to convert any amount from one currency to another. This feature is particularly useful for applications that require currency conversion for pricing or reporting purposes.

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

Time-Series Endpoint

The Time-Series Endpoint allows developers to query the API for daily historical rates between two dates of their choice. This feature is beneficial for analyzing price trends over specific periods, enabling businesses to make data-driven decisions.

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

Fluctuation Endpoint

The Fluctuation Endpoint provides information about how currencies fluctuate on a day-to-day basis. This feature is essential for traders looking to understand market volatility and make informed trading decisions.

{
"success": true,
"fluctuation": true,
"start_date": "2026-09-01",
"end_date": "2026-09-08",
"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"
}

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

The OHLC Price Endpoint allows developers to query the API for the open, high, low, and close prices for a specific time period. This data is crucial for technical analysis and helps traders identify trends and make informed decisions.

{
"success": true,
"timestamp": 1788826317,
"base": "USD",
"date": "2026-09-08",
"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"
}

Historical LME Endpoint

The Historical LME Endpoint provides access to historical rates for LME symbols dating back to 2008. This endpoint is particularly useful for developers looking to analyze historical data for metals traded on the London Metal Exchange.

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

API Key and Authentication

To access the Metals-API, developers must use an API key, which is a unique identifier passed into the API base URL's access_key parameter. This key is essential for authentication and ensures that only authorized users can access the API's features. Developers should keep their API keys secure and not expose them in public repositories.

API Response Structure

The API responses delivered by the Metals-API are, by default, relative to USD. All data is returned in a structured JSON format, making it easy for developers to parse and utilize the information in their applications. Understanding the structure of the API responses is crucial for effective integration.

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. This resource is invaluable for developers looking to work with specific metals and their corresponding codes.

Conclusion

In conclusion, the Metals-API offers a powerful and flexible solution for developers seeking to retrieve historical prices for metals, including the São Tomé and Príncipe Dobra (STD). With its extensive range of endpoints, real-time data capabilities, and comprehensive documentation, the Metals-API empowers developers to create innovative applications that leverage historical and current market data.

By understanding the various features and functionalities of the Metals-API, developers can build applications that provide valuable insights into metal pricing trends, enabling businesses to make informed decisions in a rapidly changing market. For further exploration, visit the Metals-API Website and dive into the Metals-API Documentation for detailed implementation guidance.