LogoCommodityPriceAPI

Real-Time Commodity Prices  API for Developers

Access live market rates for 170+ assets including Gold, Silver, WTI Crude, and Brent Oil. Integrate high-frequency JSON data with 60-second updates into any application in minutes.

Unlimited free trial for integrations. No credit card required.

Loading...
170+
Commodities
150+
Quote Currencies
99.97%
Uptime SLA
<80ms
Avg Response
RedStone FinanceBlockAppsVýkup JinočanyQveris AIQveris AIValona IntelligenceRebel OilRoveroTíaViaphoton
Core Features

Everything you need to build with commodity data — 170+ symbols, 150+ quote currencies, one JSON API

title

170+ Commodities in One API

Query live and historical prices for 170+ commodities — precious metals, energy, agriculture, and industrial materials — through a single JSON API instead of juggling multiple data vendors.

title

Integrate in Under 5 Minutes

One API key, one REST call, one JSON response. Copy-paste examples take you from signup to your first live price in under 5 minutes — no SDK required.

title

7-Day Free Trial, Cancel Anytime

Simple monthly or annual plans with no long-term contracts. Start with a 7-day free trial, then upgrade, downgrade, or cancel whenever you like.

title

Exchange-Grade Data Sources

Prices aggregated from trusted global exchanges and financial institutions and refreshed second-by-second, so your application never runs on stale data.

title

Prices in 150+ Currencies

Get any commodity price denominated in the currency you need with a single quote parameter. 150+ world currencies supported out of the box.

01

02

03

Live Rates and Historical Data, 1 Call Away.

Fetch the latest spot rates the moment markets move, or pull the closing rate for any past date — each is a single GET request to one endpoint.

Every response is clean JSON with a unit and timestamp per symbol, ready to drop straight into dashboards, alerts, or pricing engines.

New — Official MCP Server

Connect Claude, Cursor & any AI agent to live commodity prices

The official CommodityPriceAPI MCP server exposes gold, silver, oil, and 140+ commodities as AI tools. One npx command — no code required. Ask your AI assistant for live rates, historical data, and fluctuations directly.

npx -y @commoditypriceapi/mcpSet up the MCP server
DOCUMENTATION

Commodity Price API Documentation

Simple and easy to use API for commodity prices. Get real-time and historical data for oil, gold, silver, corn, wheat, natural gas and more.

CommodityPriceAPI

CommodityPriceAPI provides a simple REST API for live and historical rates for 170+ commodities in a simple JSON format. Rates are available historically for all days going back up to 1st January, 1990.

This documentation provides complete details of the features and options available in this API.

Base API URL

https://api.commoditypriceapi.com/v2

Authentication

The CommodityPriceAPI uses API keys to authenticate requests. Each request must contain your API key via an apiKey query parameter or x-api-key request header.

In order to use the API, you need to sign up. No credit card required. Once you've created your account, get your API key from your dashboard, where you can also extend your trial, manage your subscription, and monitor usage.

We strongly discourage the use of API keys in client-side JavaScript, as it will expose your API key to the public.

Get Your API Key

You can get your API key from the Dashboard page.

Do not share your API key in publicly accessible areas such as GitHub, client-side code, and so forth.

Send Your API Key

The API Key may be sent in two ways:

  1. Request Parameter — include an apiKey parameter in your request's query string.
  2. Request Header — include an x-api-key request header with each request.

Track Usage

You can track your API usage in the Dashboard and via the Usage endpoint.

Errors and Codes

The CommodityPriceAPI returns error status using both conventional HTTP codes and error messages within the JSON response body. The error body will have the following attributes:

Error Body

timestampDATE

API responses contain a timestamp field of type DATE. It is used to identify the time of the request.

pathString

API responses contain a path field of type String. It is used to identify the request path.

codeString

API responses contain a code field of type String. This denotes the status code for the error.

errorString

A short, standardized error code indicating the type of error. Common values include VALIDATION_ERROR, BAD_REQUEST, UNAUTHORIZED, etc. Useful for programmatic error handling.

messageString

A human-readable description providing details about the error. It explains what went wrong and may offer guidance on how to resolve the issue.

HTTP Status Codes

The API returns a 200 HTTP status in case of a successful request and error status via the HTTP status codes below. The error object has the attributes mentioned above. The following table contains the common errors.

CodeErrorMessage
400VALIDATION_ERRORSymbols are required in the query parameters
401API_KEY_NOT_FOUNDAPI key is missing from the request. Please include your API key in the request headers
402PAYMENT_REQUIREDPlease extend your trial or subscribe to a plan to continue using the API
402PAYMENT_REQUIREDUser does not have an active subscription.
402PAYMENT_REQUIREDMaximum symbols per request exceeded
403LIMIT_REACHEDAPI key usage limit reached, Please upgrade your plan.
404USER_NOT_FOUNDThe user with the specified API key was not found (Invalid API key)
404SYMBOL_NOT_FOUNDThe symbol is not supported, please visit the documentation for a list of supported symbols
429TOO_MANY_REQUESTSToo many requests, please try again in a minute
500SERVER_ERRORA server error occurred and the request was not able to be processed.

Supported Symbols

Browse the full list of commodity symbols supported by the API, including their category, default currency, and measuring unit.

View Supported Symbols

Quoted Currencies

Premium and Plus subscribers can request rates in any of the supported quote currencies. Browse the full list to find the currency code you need.

View Quoted Currencies

Usage Endpoint

GET/v2/usage

Returns the current usage and quota information for your account.

Endpoint

Request Object

  • apiKeystringrequired
    Your unique API key. Note: may also be passed via x-api-key header.

Response Object

  • planstring
    Your current plan name.
  • quotainteger
    Your current allotted quota.
  • usedinteger
    Your usage since start of month, subscription, or trial.

Response JSON

Symbols Endpoint

GET/v2/symbols

Returns the complete information of all supported commodities, including symbol, category, currency (code, name, symbol), measuring unit and name.

Endpoint

Request Object

  • apiKeystringrequired
    Your unique API key. Note: may also be passed via x-api-key header.

Response Object

  • successboolean
    true if the request was successful, false if there was an error.
  • symbolsobject []
    Array of available commodity symbols with their metadata.

Response JSON

Latest Rates

GET/v2/rates/latest

Returns the latest rates for the specified symbols. Depending on your subscription plan, the latest rates may be delayed by up to 10 minutes.

Lite users receive rates in the default quote currency of a commodity. Premium and Plus users can customize the quote currency via a query parameter.

Latest rates for deprecated symbols are not available; however, you can access historical rates up to a symbol's deprecation date. View deprecated symbols.

Endpoint

Request Object

  • apiKeystringrequired
    Your unique API key. Note: may also be passed via x-api-key header.
  • symbolsstring []required
    Comma-separated list of commodity symbols.
  • quotestringoptional
    Target currency for the exchange rate; if omitted, the default quote currency is used. View supported quote currencies.

Response Object

  • successboolean
    Boolean indicator of API request success. true for successful requests.
  • timestampnumber
    Unix timestamp indicating when the response was generated.
  • ratesobject
    Object containing the current rates for each requested commodity.
  • metaDataobject
    Object containing metadata for the symbols, such as their unit and quote currency.

Response JSON

HTTP Error Codes

CodeErrorMessage
404QUOTE_NOT_FOUNDThe quote currency is invalid, please visit the documentation for a list of valid quote currencies

Historical Rates

GET/v2/rates/historical

Historical rates are available for most commodities since 1990-01-01. Query the API for historical rates by passing a date (format YYYY-MM-DD) as a URL parameter.

If the rate of a commodity for a specific date is unavailable, the API returns the most recent available rate along with its corresponding date.

For monthly commodities, only their closing rates are available in the historical data. See the available symbols.

Endpoint

Request Object

  • apiKeystringrequired
    Your unique API key. Note: may also be passed via x-api-key header.
  • symbolsstring []required
    Comma-separated list of commodity symbols.
  • datestringrequired
    Date for which the rates are requested. Format: YYYY-MM-DD.

Response Object

  • successboolean
    Boolean indicator of API request success.
  • datestring
    Date for which the user requested the commodity price. Format: YYYY-MM-DD.
  • ratesobject
    Object containing the requested rates.
  • rates.datestring
    Date for which commodity prices were fetched. Format: YYYY-MM-DD.
  • rates.opennumber
    The opening price of the commodity on the given date.
  • rates.highnumber
    The highest price of the commodity recorded on the given date.
  • rates.lownumber
    The lowest price of the commodity recorded on the given date.
  • rates.closenumber
    The closing price of the commodity on the given date.

Response JSON

HTTP Error Codes

CodeErrorMessage
400VALIDATION_ERRORDate is required in query params.
400VALIDATION_ERRORInvalid Date Format (YYYY-MM-DD).
400VALIDATION_ERRORInvalid Date: The provided date does not exist.
404RATE_NOT_FOUNDNo rate found for the specified date.

Time Series

GET/v2/rates/time-series

Query the API for daily historical rates between two dates of your choice. The difference between start and end date should not exceed 1 year.

For monthly commodities, only their closing rates are available in the time-series data.

Endpoint

Request Object

  • apiKeystringrequired
    Your unique API key. Note: may also be passed via x-api-key header.
  • symbolsstring []required
    Comma-separated list of commodity symbols.
  • startDatestringrequired
    Start date for the time series. Format: YYYY-MM-DD.
  • endDatestringrequired
    End date for the time series. Format: YYYY-MM-DD.
The maximum difference between the start and end date is 1 year.

Response Object

  • successboolean
    Boolean indicator of API request success.
  • startDatestring
    Start date for the time series. Format: YYYY-MM-DD.
  • endDatestring
    End date for the time series. Format: YYYY-MM-DD.
  • ratesobject
    Object containing the requested rates, keyed by date.

Response JSON

HTTP Error Codes

CodeErrorMessage
400VALIDATION_ERRORstartDate is required in query params
400VALIDATION_ERRORendDate is required in query params
400VALIDATION_ERRORInvalid date format specified for start or end date
400VALIDATION_ERRORStart date cannot be after end date
400VALIDATION_ERRORDate range exceeds the allowed limit.
400VALIDATION_ERRORInvalid Date: The provided date does not exist.
404DATA_NOT_FOUNDNo data found for the specified date range

Fluctuation

GET/v2/rates/fluctuation

Returns information about how rates of different commodities fluctuate over a date range. Provide a startDate and endDate as query parameters and select which symbols you want to query.

Endpoint

Request Object

  • apiKeystringrequired
    Your unique API key. Note: may also be passed via x-api-key header.
  • symbolsstring []required
    Comma-separated list of commodity symbols.
  • startDatestringrequired
    Start date for the fluctuation. Format: YYYY-MM-DD.
  • endDatestringrequired
    End date for the fluctuation. Format: YYYY-MM-DD.

Response Object

  • successboolean
    Boolean indicator of API request success.
  • startDatestring
    Start date for the fluctuation. Format: YYYY-MM-DD.
  • endDatestring
    End date for the fluctuation. Format: YYYY-MM-DD.
  • ratesobject
    Object containing the requested rates per symbol.
  • rate.startRatenumber
    Starting rate for the fluctuation.
  • rate.endRatenumber
    Ending rate for the fluctuation.
  • rate.changenumber
    The change between the starting and ending rates. Negative values represent a decrease.
  • rate.changePercentnumber
    The change percent between the starting and ending rates. Negative values represent a decrease.

Response JSON

HTTP Error Codes

CodeErrorMessage
400VALIDATION_ERRORstartDate is required in query params.
400VALIDATION_ERRORendDate is required in query params.
400VALIDATION_ERRORInvalid date format specified for start or end date.
400VALIDATION_ERRORStart date cannot be after end date
400VALIDATION_ERRORInvalid Date: The provided date does not exist.
404DATA_NOT_FOUNDNo data found for the specified date range
Loading...

Frequently Asked Questions

Get your API key today

CommodityPriceAPI is the easiest way to get real-time and historical prices for a diverse range of commodities. Our API is easy to use and can be integrated into your application in minutes.

Get API key