Gold Price Trend API

Gold price trend analysis across multiple timeframes — barometer for risk appetite and macro uncertainty.

Webhook URL

https://api.hunchmachine.com/webhook/indicators?indicator=gold_price_trend&api_key=YOUR_API_KEY

Description

Tracks the price trend of gold (XAU/USD), one of the world's primary "safe haven" assets. Movements in gold often reflect shifts in investor sentiment, inflation expectations, and macroeconomic uncertainty — making it a key barometer for global risk appetite.

What this endpoint provides

A simplified snapshot of gold's price and trend across multiple timeframes, with percentage changes and an interpreted trend label. It's useful for automations and AI agents that need to gauge whether the broader environment is tilting toward risk-off or risk-on conditions.

Response fields

gold_price_usd

Latest gold price per ounce in USD.

change_7d_pct, change_30d_pct, change_90d_pct

Percentage changes over 7, 30, and 90 days.

trend_90d

Current medium-term directional trend (up, down, or flat).

summary

Human-readable summary including price, performance, and trend interpretation.

timestamp

UTC time of the most recent update.

Output example

[
  {
    "indicator": "gold_price_trend",
    "gold_price_usd": 3997.15,
    "change_7d_pct": -3.02,
    "change_30d_pct": 6.31,
    "change_90d_pct": 19.35,
    "trend_90d": "up",
    "summary": "Gold at $3,997 (-3.0% 7d, 6.3% 30d, 19.3% 90d) — up trend.",
    "timestamp": "2025-11-01T01:22:27.339Z"
  }
]

Interpretation & Use

Gold tends to rise during periods of uncertainty, inflation concern, or tightening liquidity, and fall when investors rotate toward risk assets. A sustained "up" trend suggests defensive positioning or inflation hedging. A "down" trend can signal confidence in growth and a shift toward equities or crypto. Automations can use the trend_90d or the textual summary to classify macro tone ("risk-on" vs. "risk-off") or feed the information directly into reasoning agents for macro context evaluation.