Announcing the new /hourly API Endpoint

We are thrilled to announce a powerful new addition to MetalPriceAPI: the /hourly endpoint. This endpoint provides hourly exchange rate data for a given currency over a date range, giving you up to 24 data points per day for granular intraday analysis.

Why Hourly Data Matters

Daily historical data is great for tracking long-term trends, but it can miss significant price movements that happen within a single day. With hourly data, you can:

• Spot Intraday Price Movements: Identify price spikes, dips, and trends that occur throughout the day.
• Perform Granular Analysis: Analyze how metal prices react to market events on an hour-by-hour basis.
• Make Better-Timed Decisions: Use intraday patterns to optimize the timing of trades and purchases.

How to Use the /hourly Endpoint

To access hourly data, make a GET request to the following URL:

https://api.metalpriceapi.com/v1/hourly?api_key=[API_KEY]&base=[BASE]&currency=[CURRENCY]&start_date=[START_DATE]&end_date=[END_DATE]

Request Parameters

• api_key: [Required] Your unique API key. Replace [API_KEY] with your actual key to authenticate your request.
• base: [Optional] The base currency symbol. Defaults to USD.
• currency: [Required] A single quote currency symbol (e.g., XAU).
• start_date: [Optional] The start date for the data range, in YYYY-MM-DD format.
• end_date: [Optional] The end date for the data range, in YYYY-MM-DD format.

Example API Response

Upon a successful request, you will receive a response in JSON format:

{
    "success": true,
    "base": "USD",
    "start_date": "2025-11-03",
    "end_date": "2025-11-03",
    "rates": [
        {
            "timestamp": 1762128000,
            "rates": {
                "XAU": 0.0002512844,
                "USDXAU": 3979.5546400811
            }
        },
        {
            "timestamp": 1762131600,
            "rates": {
                "XAU": 0.0002519176,
                "USDXAU": 3969.5519487324
            }
        },
        ...
    ]
}

Response Attributes

• success: Indicates whether the API request was successful.
• base: The base currency used in the request.
• start_date: The start date of the returned data range.
• end_date: The end date of the returned data range.
• rates: An array of hourly data points, each containing:
  • timestamp: The Unix timestamp for that hour.
  • rates: The exchange rates for the requested currency at that hour.

Key Details

• One currency per request: The /hourly endpoint accepts a single currency symbol per request.
• Date range limits: Free plan users can query up to 2 days of hourly data; paid plan users can query up to 7 days.
• Date shortcuts: Use convenient shortcuts like today, yesterday, or week for the start_date and end_date parameters.
• Math operator support: Apply mathematical operations to your hourly rates using the math parameter, just like with other endpoints.

Get Started Today

To start using the /hourly endpoint, simply include your API key in the request URL and retrieve your hourly data instantly. For more details, visit our API documentation.

We hope this new feature enhances your experience with MetalPriceAPI. As always, we are here to support you. If you have any questions or need assistance, please contact our support team.

— MetalpriceAPI Team