Knowledge Base/Does Massive support commodities data?

Does Massive support commodities data?

Yes, through the Futures subscription: crude oil, natural gas, gold, silver, copper, platinum, palladium, corn, wheat and soybeans all have live contracts. Gold and silver are additionally available as forex pairs on the Currencies subscription.

Yes. Commodities are covered through the Futures subscription, where the exchange-listed contracts trade: energy, metals and grains all have live products. Gold and silver are covered a second way as well, quoted as currency pairs on the Currencies subscription, which suits you if you want a spot rate rather than a dated contract. What Massive does not have is a separate commodities product, which is why the answer depends on which subscription you hold.

Applies to

  • Plans: a Futures subscription for the contracts; a Currencies subscription for the gold and silver forex pairs.
  • Endpoints: /futures/v1/... for contracts, products and aggregates; the forex endpoints and the /forex WebSocket cluster for the metal pairs.
  • Asset classes: futures and forex.

Which commodities are covered as futures

Each of these is a product on /futures/v1/products, with dated contracts trading today:

CommodityProduct codeGroupVenue
Crude oilCLEnergyNYMEX
Natural gasNGEnergyNYMEX
GoldGCMetalsCOMEX
SilverSIMetalsCOMEX
CopperHGMetalsCOMEX
PlatinumPLMetalsNYMEX
PalladiumPAMetalsNYMEX
CornZCGrainsCBOT
WheatZWGrainsCBOT
SoybeansZSGrainsCBOT

A contract ticker adds a month and year code to the product, so December 2026 wheat is ZWZ6 and November 2026 crude is CLX6.

How to query a commodity future

curl -X GET "https://api.massive.com/futures/v1/aggs/CLX6?resolution=1session&limit=1&apiKey=YOUR_API_KEY"

Response

{
  "results": [
    { "ticker": "CLX6", "session_end_date": "2026-09-15", "close": 98.38 }
  ],
  "status": "OK"
}

resolution=1session&limit=1 asks for the most recent session, so the close you get back is whatever that session settled at rather than the figure above.

To find the contracts trading for a product, list them from /futures/v1/contracts?product_code=CL rather than constructing the month codes by hand.

Gold and silver as forex pairs

Gold and silver are also quoted as currency pairs, which is the simpler route if you want a continuous spot rate with no contract to roll:

  • Gold is C:XAUUSD, and against 14 other currencies: ARS, AUD, BRL, CAD, CNY, EUR, GBP, INR, JPY, KRW, MXN, RUB, SAR and ZAR.
  • Silver is C:XAGUSD, against the same set plus TRY, so 16 pairs in all.

The X follows the ISO 4217 convention for a unit that is not a national currency, and one unit is one troy ounce.

Platinum and palladium used to be quoted this way as C:XPTUSD and C:XPDUSD. Those pairs are retired: their last bar is dated 1 February 2024 and their ticker records are marked inactive. Use the PL and PA futures instead.

Why the same metal appears in two places

The same metal appears twice because a futures contract and a spot pair are different instruments. A future has an expiry, a delivery point and a contract size, and it is what trades on an exchange. A spot pair is a continuously quoted rate with no expiry. Which one you want depends on whether you are pricing an exposure or tracking a market, and the two will not agree exactly, because a future carries the cost of carry to its delivery date.

If you see an error

An empty results array from a forex request for C:XPTUSD or C:XPDUSD, or a stale-looking previous close, is the retirement above. Note that /prev returns the last bar that ever existed, however old, so always read its date before treating a pair as live.

{"status":"NOT_AUTHORIZED"} on a futures endpoint means your plan has no Futures subscription. Currencies does not cover it, and neither does Stocks.

An empty result for a contract ticker you built by hand is usually the wrong month or year code. List the contracts for the product instead.

Related


Was this article helpful?

Modernizing Wall St.

Reimagining financial market data for the 21st century.

Schedule a demo

Talk with our market data experts

Recommended

Can't find the answer you're looking for? Contact our team.
  • Title
    Are all indices available through the basic subscription tier?
    Data Coverage Category

    Data Coverage

    Indices Category

    Indices

    Description
    No, and the ones it withholds are the famous ones: SPX, DJI, RUT and VIX all need a paid Indices tier. Basic still reaches more than 10,000 of the 13,000-odd indices Massive publishes, and NDX and the Nasdaq Composite are among them.
  • Title
    Does Massive offer dark pool data?
    Data Coverage Category

    Data Coverage

    Stocks Category

    Stocks

    Description
    Yes. Off-exchange prints, which include dark pool executions, arrive on the ordinary trades feed and are identified by an exchange ID of 4. There is no separate dark pool endpoint, and no way to tell which individual venue a print came from.
  • Title
    Does Massive offer pre-market and after-hours data?
    FAQ Category

    FAQ

    Stocks Category

    Stocks

    Description
    Yes. Every extended-hours trade and quote is published, from 04:00 to 20:00 Eastern. There is no session parameter, so you select a session with timestamps, and expect far fewer aggregate bars outside regular hours because many extended-hours trades are odd lots that cannot set a price.