Introduction

Use the Metal Price API to fetch current prices, supported symbols, usage metrics, historical snapshots, and advanced market data for subscribed customers.

Base URL

The public API is exposed under the /v1 prefix on your API host.

Authentication

All public API endpoints require a valid API key in the X-API-Key request header. You receive your key after your subscription is provisioned and you can manage active keys from your customer account.

Requests without a key return 401. Revoked keys return 401. Inactive keys or suspended subscriptions return 403.

GET /v1/latest

Returns the latest available price snapshot for one or more symbols. This endpoint consumes monthly quota.

Query parameters: base optional 3-letter currency code, symbols optional comma-separated list such as XAU,XAG.

GET /v1/symbols

Returns the list of active symbols visible to the current API key. Free and Starter plans only receive symbols marked as free-access.

GET /v1/usage

Returns the current monthly usage for the authenticated subscriber, including used calls, remaining calls, and usage percentage.

GET /v1/historical/{date}

Returns historical closing prices for the given date. The date must be supplied in YYYY-MM-DD format.

GET /v1/ohlc

Returns OHLC data for a single symbol and date. This endpoint is only available when the current subscription includes OHLC access.

GET /v1/timeseries

Returns daily prices across a date range. This endpoint is only available when the subscription includes timeseries access.

Business and Enterprise plans can request up to 365 days per call. Other eligible plans are limited to 30 days per request.

GET /v1/fluctuation

Returns the start rate, end rate, absolute change, and percentage change between two dates. This endpoint is only available when the subscription includes fluctuation access.

GET /v1/convert

Converts an amount of a metal symbol into a target currency using the latest available price.

from is the metal symbol, to is the target currency, and amount defaults to 1.0 when omitted.

Errors

The API currently uses standard HTTP status codes for request failures:

Plan Notes

Availability depends on the features attached to your subscription plan. In the current implementation:

Monthly quota is enforced on data endpoints. API usage totals can be checked using /v1/usage.

Supported Symbols

Here is the current list of configured metal symbols available from the platform. Free-plan visibility is shown per symbol.