Loading
Loading
Get real-time prices for 130+ commodities in a single request. Specify one or more commodity symbols and an update frequency to receive current market prices with unit and currency metadata.
Pass a comma-separated list of commodity symbols and an update frequency (1m or 10m) to get current prices. An optional quote parameter converts prices into a desired currency.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis is version v1.0 of the API.
Both symbols and updates are required. Omitting either returns a 400 error.
formatoptionalStringdefault: jsonResponse format: 'json'.
symbolsrequiredStringComma-separated list of commodity symbols. Visit the supported symbols list for all valid values.
updatesrequiredStringdefault: 1mUpdate frequency. Accepted values: 10m (10-minute updates) or 1m (1-minute updates).
quoteoptionalStringTarget currency for the exchange rate. Defaults to the market currency of each commodity.
A successful request returns a 200 OK with current prices for each symbol and metadata describing the unit and quote currency.
successtrue for successful requests.
timestampUnix timestamp indicating when the response was generated.
Object where each key is a commodity symbol and the value is the current price.
Object containing unit and currency metadata for each requested commodity.
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
The symbol is not supported, please visit the documentation for a list of supported symbols
The quote currency is invalid, please visit the documentation for a list of valid quote currencies