What does the forward view return?

The futures settlement curve — the next forward contracts for one commodity on one call. Futures encode arbitrage-locked carry: what an institutional desk can't disagree with. Every populated horizon up to one year forward.

Docs / Forward view

Forward view

Multi-horizon futures settlement curve for one commodity on one call. This is the endpoint behind /data/gold.

XAU FREE · XAG/HG PRO+MCP TOOL PARITY

Live endpoint

GET/v1/forward-view/{asset}Bearer · Free+ (XAU) · Pro+ (XAG/HG)

Returns every populated horizon for one commodity on one call. Asset is one of XAU, XAG, HG. XAU's curve is served on every tier; XAG/HG require Pro+ — the same per-asset gate as /v1/prices.

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. We are not a licensed real-time market data redistributor.

Refresh cadences and freshness SLAs: methodology.

MCP tool

Available as get_forward_view on every tier — same per-asset gate as the REST endpoint (XAU free, XAG/HG Pro+):

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.