Payload schema · MacroGoldDrivers (XAU/USD only)
Emitted once per daily bar close by xauusd-macro-drivers.pine. Five of the seven gold drivers arrive in this single CSV payload; CPI YoY and Geopolitical Risk Index continue to come via the Macro & Rates upload (read in-page from RATE_PROB_DATA.global). Long format — one row per driver, tagged in the Type column — so the schema is extensible without breaking the parser.
Asset,Timeframe,BarTime,Type,Latest,Delta,DeltaUnit,RisingCount,Lookback,Observations,SignalMode,Valid,Note
XAUUSD,D,2026-06-02T20:59:00Z,realYield,2.047,12.8,bp,2,10,9,count,1,real_computed
XAUUSD,D,2026-06-02T20:59:00Z,dxy,99.215,0.8211,pct,6,10,10,count,1,
XAUUSD,D,2026-06-02T20:59:00Z,gvz,25.64,-3.67,abs,5,10,8,count,1,
XAUUSD,D,2026-06-02T20:59:00Z,gsr,59.718,-1.815,abs,4,10,10,count,1,
XAUUSD,D,2026-06-02T20:59:00Z,cbBuying,24345.72,43.71,tonnes,2,250,4,count,1,12 country GRES sum
XAUUSD,D,2026-06-02T20:59:00Z,fedHeadline,23120000000,,usd_m,,,,n/a,0,display-only; not in cbBuying sum (unit mismatch)
XAUUSD,D,2026-06-02T20:59:00Z,contributors,12,,n/a,,,,n/a,1,of 12 country GRES symbols resolved
KV key on success: MacroGoldDrivers:XAUUSD_latest.
Type column identifies each driver: realYield · dxy · gvz · gsr · cbBuying · fedHeadline (display-only) · contributors (meta-row, count of resolved GRES symbols). cpiYoY and geoRisk are not in this payload — they arrive via the Macro & Rates upload.
Self-calibrating signal model. There are no fixed level thresholds. Each driver reports RisingCount = how many of the last Lookback periods the series rose. The dashboard derives the signal as direction = RisingCount ≥ Lookback/2 ? +1 : −1, then norm = direction × driverPolarity. An exact tie (e.g. 5/10) resolves bullish under the inclusive ≥. This means the bands never need recalibrating as the market regime shifts.
Lookback windows vary per driver: realYield / dxy / gvz / gsr use a 10-bar window on the daily series; cbBuying uses 250 bars (reserves update quarterly, so the rising-count needs a far longer window to be meaningful).
Observations is how many of the Lookback periods actually had data (carried-forward / unchanged values excluded). When it drops below the driver's minimum, SignalMode flips from count to recent_change (the signal falls back to the sign of the most recent real change), which matters for quarterly series like cbBuying on an intraday chart.
DeltaUnit values: bp (basis points) · pct (percent change) · abs (absolute change) · tonnes (long-run tonnes) · usd_m (USD millions) · n/a (no delta applies).
Valid column is 1 when the driver resolved with real data; 0 when missing. The dashboard skips any Valid=0 driver (contributes 0 to the Gold Health composite), rather than treating it as a real zero signal. This matters because the Pine chart table shows 0 for missing values to keep cells from looking broken — without the Valid flag the dashboard would mis-read missing data as bearish.
realYield Note column is "real_computed" when FRED:T10YIE is available (10Y nominal minus 10Y breakeven inflation), or "nominal_fallback" when it's not.
fedHeadline row is the FRED M14062USM027NNBR series (US Treasury monetary gold stock, USD millions). Display only — not summed into the cbBuying tonnes total because of the unit mismatch, and emitted with Valid=0 so it never enters the composite.
Driver polarities & weights (composite range ±12): realYield −1 ×3 · dxy −1 ×2 · cpiYoY +1 ×2 · cbBuying +1 ×2 · geoRisk +1 ×1 · gvz +1 ×1 · gsr +1 ×1. Bands: ≥ +8 Extreme Bull · +1…+7 Bullish · 0 Neutral · −1…−7 Bearish · ≤ −8 Extreme Bear.
Payload schema · MacroOilDrivers (WTI/USD only)
Emitted once per daily bar close by WTIUSD_Oil_Macro_Drivers.pine. Three of the eight oil drivers arrive in this single CSV payload — the only three available from TradingView. The other five (inventories, opecSupply, demand, refUtil, geoRisk) are not chartable on TradingView and arrive via the Macro & Rate Tracker (EIA/OPEC/MacroMicro values + GPR), read in-page from the tracker's global fields. Identical long-format schema to MacroGoldDrivers so the same Worker parser and dashboard ingest handle it unchanged.
Asset,Timeframe,BarTime,Type,Latest,Delta,DeltaUnit,RisingCount,Lookback,Observations,SignalMode,Valid,Note
WTIUSD,D,2026-06-05T21:00:00Z,dxy,99.631,0.8431,pct,7,10,10,count,1,
WTIUSD,D,2026-06-05T21:00:00Z,ovx,58.96,-16.87,abs,2,10,10,count,1,CBOE crude oil vol
WTIUSD,D,2026-06-05T21:00:00Z,crack,44.5842,-7.3116,usd,4,10,10,count,1,3:2:1 crack, $/bbl
KV key on success: MacroOilDrivers:WTIUSD_latest.
Type column identifies each driver: dxy (Dollar Index, TVC:DXY) · ovx (CBOE Crude Oil Vol Index, CBOE:OVX) · crack (3:2:1 crack spread, calculated in-script from NYMEX:CL1! crude, NYMEX:RB1! gasoline, NYMEX:HO1! heating oil — products converted $/gal→$/bbl via ×42, spread = (2·gasoline + 1·heatoil − 3·crude) / 3).
Same self-calibrating signal model as the gold payload: direction = RisingCount ≥ Lookback/2 ? +1 : −1, then norm = direction × driverPolarity. All three are dense daily series, so a 10-bar window and the count mode apply (the recent_change fallback is retained for schema parity but rarely triggers).
DeltaUnit values: pct (DXY % change) · abs (OVX absolute change) · usd ($/bbl change in the crack spread).
Valid column works as in the gold payload — 0 means a symbol failed to resolve (e.g. CBOE:OVX not in the TradingView plan) and the dashboard skips that driver rather than reading it as a real zero.
Driver polarities & weights (these three only; full composite range ±15 across all 8): dxy −1 ×2 · ovx +1 ×1 · crack +1 ×1. The five non-TradingView drivers — inventories −1 ×3 · opecSupply −1 ×3 · demand +1 ×2 · geoRisk +1 ×2 · refUtil +1 ×1 — come from the Macro & Rate Tracker, not this payload.