Commodity Price API

Endpoint

Replace gold with any supported commodity slug, such as silver, oil, brent, natural-gas, copper, corn, or nickel.

Non-energy quote units and source roles

Precious metals, base metals, and grains include machine-readable quote context on individual latest endpoints: quoteUnit, contractHint, venueHint, sourceFrequency, sourceRole, and riskNote. Preserve these fields when displaying alerts, widgets, or AI-generated answers.

Energy benchmarks endpoint

Fetch WTI, Brent, and Henry Hub in one response for energy dashboards, widgets, and AI citation tools. Energy rows include benchmarkName, quoteUnit, exchangeHint, and marketSessionHint in addition to the standard latest-price fields.

Individual routes remain available at /api/v1/commodity/oil/latest, /api/v1/commodity/brent/latest, and /api/v1/commodity/natural-gas/latest.

Response fields

slug

Commodity identifier used in the URL.

observationDate

Calendar date associated with the market observation.

observedAt

Timestamp or market date for the quoted observation.

priceUsd

Latest stored USD quote for the commodity.

headlinePriceUsd

Same headline USD quote with non-legacy naming.

displayUnitHint

Plain-language unit for priceUsd, such as USD per barrel.

quoteUnit

Machine-readable quote unit, such as USD/troy oz, USD/lb, USD/mt, USD/bu, USD/bbl, or USD/MMBtu.

sourceRole

Whether the source is spot-style, futures-style, macro fallback, or benchmark data.

riskNote

Unit, frequency, or fallback caveat that should be preserved in public displays.

source

Short source key for the active price feed.

frequency

Best-known frequency of the selected stored observation.

provenanceLine

Human-readable source and cross-check note.

ingestedAt

Server timestamp when the row was ingested.

Caching, limits, and attribution

Responses use public cache headers with short revalidation windows. If no API key is configured, requests are rate-limited by IP. When showing values publicly, include the observation time and provenance line so readers understand the source and freshness of the data.