What does the forward view return?

The response includes the next available futures contracts for one commodity, up to one year out. Each horizon includes the contract and settlement data when available.

Docs / Forward view

Forward view

Futures curve for existing subscribers on legacy plans. Powers /data/gold.

Legacy plans onlyMCP TOOL PARITY

Live endpoint

GET/v1/forward-view/{asset}Bearer · Legacy plans only

Returns every populated horizon for one commodity on one call. Asset is one of XAU, XAG, HG.

Path parameters

assetstringREQUIRED: One of XAU (gold), XAG (silver), HG (copper).

Response shape

Returns a ForwardViewResponse with asset, spot_usd, computed_at, and a horizons[] array. Each horizon row has:

expiry: ISO YYYY-MM-DD
futures: settle price + contract code (or null if no contract matches this horizon)

Plus a top-level sources[] array for attribution and an errors[] array for partial-failure surfacing.

The futures curve

The chart at /data/gold renders the market-implied forward price path directly.

Futures curve: next 5 forward gold contracts. Settle prices ~15 minutes delayed via our primary delayed-feed series with a secondary fallback. Futures values come from publicly available delayed feeds and are not licensed real-time data.

Refresh cadences and freshness SLAs: methodology.

MCP tool

get_forward_view: Legacy plans only. Futures curve:

get_forward_view(asset: "XAU" | "XAG" | "HG")
  -> { asset, spot_usd, computed_at, horizons[], sources[], errors[] }

Same response shape as the REST endpoint. See /docs/mcp for setup.