Coffee Price API

Frequently Asked Questions

• Can I use the Commodity Price API for commercial purposes?

  Yes, but you must have a premium subscription. Commercial use of the Commodity Price API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

• How do I get an API key and start using the Commodity Price API?

  Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

• What happens if I exceed my quota for the month?

  Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.

• What happens if a request to the Commodity Price API fails?

  The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

• What commodities and endpoints does the Commodity Price API cover?

  It provides real-time prices for dozens of commonly-traded commodities across categories like precious_metals, base_metals, energy, grains, softs, and livestock on exchanges including CME, NYMEX, COMEX, and ICE. Available endpoints include /v1/commodityprice for one or more commodities, /v1/commoditysnapshot for every commodity at once, /v1/commoditypricehistorical for OHLCV history, plus /v1/commoditycontract, /v1/commoditycontractlist, and /v1/commodityforwardcurve; see the full list of finance APIs on our APIs page.

• How do I query a single commodity's price and convert its currency or unit?

  Call /v1/commodityprice with the name parameter (e.g., gold or platinum), or pass a comma-separated names list of up to 30 commodities for a batch request. You can add the optional currency parameter (an ISO 4217 code like EUR or GBP) and the unit parameter (such as kg, barrel, or MMBtu) to convert the price; for a comparable single-commodity service see the Gold Price API.

• What does the /v1/commodityprice response include?

  Each result returns the exchange, name, price, and the quote convention via currency_unit (USD or USX cents) and unit, along with previous_close, change_24h, change_24h_percent, high_24h/low_24h, high_52w/low_52w (Developer tier and above), and an updated Unix timestamp. Free users receive 15-minute delayed data while premium members get live prices, which you can compare on the pricing page.

• How can I analyze whether a commodity is in contango or backwardation?

  Use the /v1/commodityforwardcurve endpoint with the name parameter (e.g., crude_oil) to get every active futures contract sorted by month plus a structure classification of contango, backwardation, mixed, or flat, along with contango_slope_1m_pct and contango_slope_12m_pct slopes and a full curve array. This endpoint requires a Business, Professional, or annual subscription, which you can sign up for here.