Commodity Price API

The Commodity Price API provides access to real-time commodity prices for dozens of commonly-traded commodities in major exchanges (CME, NYMEX, etc.). Prices are based on rolling futures contracts.

Available endpoints:

/v1/commoditycontract - Get price information for a specific commodity contract
/v1/commoditycontractlist - Get a list of all available commodity contracts
/v1/commodityprice - Get current price information for any given commodity
/v1/commoditypricehistorical - Get historical price data for any given commodity

(4.3)

From 9,027 users

4,300+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average	P50	P75	P90	P95
257ms	273ms	311ms	560ms	1065ms

Didn't find what you were looking for? Suggest an improvement

/v1/commoditycontract GET Business, Professional, or annual subscriptions Only

https://api.api-ninjas.com/v1/commoditycontract

Returns price information for a specific commodity contract or all contracts matching a commodity root.

Either symbol or symbol_root must be provided, but not both.

Parameters

symbol optional
Specific contract symbol to look up (e.g., GCK26).
symbol_root optional
Commodity root to filter contracts (e.g., GC returns all contracts starting with GC like GCK26, GCM26, etc.).

Headers

X-Api-Key required
API Key associated with your account.

Response

symbol
The full contract symbol.
last_price
The last price of the commodity contract.
last_updated
The Unix timestamp of when the price was last updated.

Sample Request Live Demo!

symbol

symbol_root

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/commoditycontract?symbol=GCK26

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1
2

curl -X GET "https://api.api-ninjas.com/v1/commoditycontract?symbol=GCK26" \
  -H "X-Api-Key: YOUR_API_KEY"

/v1/commoditycontractlist GET Business, Professional, or annual subscriptions Only

https://api.api-ninjas.com/v1/commoditycontractlist

Returns a list of all available commodity contracts with their symbols and commodity names. This endpoint is useful for discovering which contracts are available for querying.

Parameters

None

Headers

X-Api-Key required
API Key associated with your account.

Response

symbol
The full contract symbol (e.g., "GCK26").
commodity
The name of the commodity (e.g., "Gold", "Soybean Oil").

Sample Request Live Demo!

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/commoditycontractlist

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1
2

curl -X GET "https://api.api-ninjas.com/v1/commoditycontractlist" \
  -H "X-Api-Key: YOUR_API_KEY"

/v1/commodityprice GET

https://api.api-ninjas.com/v1/commodityprice

Returns the current price information for any given commodity. All quoted prices are in USD.

For historical commodity prices, see /v1/commoditypricehistorical.

Parameters

`name` required

Name of commodity. Free tier users have access to 7 commodities per week. These commodities rotate weekly on a deterministic schedule. Premium users have access to all commodities. The supported values are:

Value	Description
`gold`	Gold Futures Premium only
`soybean_oil`	Soybean Oil Futures Premium only
`wheat`	Wheat Futures Premium only
`platinum`	Platinum Premium only
`micro_silver`	Micro Silver Futures
`lean_hogs`	Lean Hogs Futures
`corn`	Corn Futures Premium only
`oat`	Oat Futures Premium only
`aluminum`	Aluminum Futures Premium only
`soybean_meal`	Soybean Meal Futures Premium only
`silver`	Silver Futures Premium only
`soybean`	Soybean Futures Premium only
`lumber`	Lumber Futures
`live_cattle`	Live Cattle Futures
`sugar`	Sugar Premium only
`natural_gas`	Natural Gas
`crude_oil`	Crude Oil Premium only
`orange_juice`	Orange Juice Premium only
`coffee`	Coffee Premium only
`cotton`	Cotton Premium only
`copper`	Copper Premium only
`micro_gold`	Micro Gold Futures
`feeder_cattle`	Feeder Cattle Futures Premium only
`rough_rice`	Rough Rice Futures Premium only
`palladium`	Palladium Premium only
`cocoa`	Cocoa Premium only
`brent_crude_oil`	Brent Crude Oil Premium only
`gasoline_rbob`	Gasoline RBOB Premium only
`heating_oil`	Heating Oil
`class_3_milk`	Class III Milk Futures Premium only

Headers

X-Api-Key required
API Key associated with your account.

Response

exchange
The symbol of the exchange where the commodity is traded.
name
The name of the commodity.
price
The current price of the commodity in USD.
updated
The Unix timestamp of the price update.

Sample Request Live Demo!

name

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/commodityprice?name=platinum

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1
2

curl -X GET "https://api.api-ninjas.com/v1/commodityprice?name=gold" \
  -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

/v1/commoditypricehistorical GET Premium Only

https://api.api-ninjas.com/v1/commoditypricehistorical

Returns historical commodity futures price data in OHLCV (Open, High, Low, Close, Volume) format. The data is returned in descending order (most recent first), and all prices are in USD.

Parameters

name required
Name of commodity. Use the same values as the name parameter in /v1/commodityprice.
period optional
Time interval between data points. Valid values are: 1m, 5m, 15m, 30m, 1h, 4h, 1d. Default is 1h.
start optional
Start timestamp in Unix format. If not provided, defaults to 24 hours ago.
end optional
End timestamp in Unix format. If not provided, defaults to current time.

Headers

X-Api-Key required
API Key associated with your account.

Response

open
The opening price of the commodity in USD.
low
The lowest price of the commodity in USD.
high
The highest price of the commodity in USD.
close
The closing price of the commodity in USD.
volume
The volume of the commodity.
time
The Unix timestamp of the price update.

Sample Request Live Demo!

name

period

start

end

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/commoditypricehistorical?name=gold&period=1h

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Commodity Price API

/v1/commoditycontract GET Business, Professional, or annual subscriptions Only

Parameters

symbol optional

symbol_root optional

Headers

X-Api-Key required

Response

symbol

last_price

last_updated

Sample Request Live Demo!

Sample Response

Code Examples

/v1/commoditycontractlist GET Business, Professional, or annual subscriptions Only

Parameters

Headers

X-Api-Key required

Response

symbol

commodity

Sample Request Live Demo!

Sample Response

Code Examples

/v1/commodityprice GET

Parameters

name required

Headers

X-Api-Key required

Response

exchange

name

price

updated

Sample Request Live Demo!

Sample Response

Code Examples

/v1/commoditypricehistorical GET Premium Only

Parameters

name required

period optional

start optional

end optional

Headers

X-Api-Key required

Response

open

low

high

close

volume

time

Sample Request Live Demo!

Sample Response

`symbol` optional

`symbol_root` optional

`X-Api-Key` required

`symbol`

`last_price`

`last_updated`

`X-Api-Key` required

`symbol`

`commodity`

`name` required

`X-Api-Key` required

`exchange`

`name`

`price`

`updated`

`name` required

`period` optional

`start` optional

`end` optional

`X-Api-Key` required

`open`

`low`

`high`

`close`

`volume`

`time`