SearchCtrl+K

Live Commodity Prices API Reference

Get real-time prices for 245+ commodities in a single request. Specify one or more commodity symbols to receive current market prices, refreshed every minute, with unit and currency metadata.

GEThttps://api.apifreaks.com/v2.0/commodity/rates/latest

Test

Pass a comma-separated list of commodity symbols to get current prices. An optional quote parameter converts prices into a desired currency. If some symbols can't be resolved, the API returns 206 Partial Content with an unresolved object instead of failing the whole request.

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v2.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v2.0/commodity/rates/latest?symbols=WTIOIL-SPOT%2CXAU' \
  -H 'X-apiKey: API-KEY'

Response

{
  "success": true,
  "timestamp": 1789386964,
  "rates": {
    "WTIOIL-SPOT": 100.02,
    "XAU": 4291.77
  },
  "metadata": {
    "WTIOIL-SPOT": {
      "unit": "Bbl",
      "quote": "USD"
    },
    "XAU": {
      "unit": "T.oz",
      "quote": "USD"
    }
  }
}

API Request

Query Parameters

symbols is required. Omitting it returns a 400 error.

formatoptionalStringdefault: json

Response format: json.

symbolsrequiredString

Comma-separated list of commodity symbols. Visit the supported symbols list for all valid values.

quoteoptionalString

Target currency for the exchange rate. Defaults to the market currency of each commodity.

API Response Schema

A successful request returns a 200 OK with current prices for each symbol and metadata describing the unit and quote currency.

success

Booleanmandatory

true for successful requests.

timestamp

Floatmandatory

Unix 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.

Present only on a 206 Partial Content response, when some requested symbols could not be resolved. Object where each key is an unresolved symbol and the value contains a detail message.

warning

Stringoptional

Present only when currency conversion for the requested quote is temporarily unavailable; rates are then returned in each commodity's default currency instead.

Custom Response Headers

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 endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

please pass correct parameters

402

Maximum symbols per request exceeded

404

The symbol is not supported, please visit the documentation for a list of supported symbols

404

The quote currency is invalid, please visit the documentation for a list of valid quote currencies