Gold data

    THE GOLD DATA API.

    Gold Hunts publishes its gold desk as machine-readable JSON so agents can call it, not just quote it. Five free endpoints cover XAUUSD session calls with scored outcomes, the broker-verified win-rate record, session windows in UTC, the gold glossary and every calculator formula. No key, no account, CORS enabled — attribution to goldhunts.com is the only condition.

    ENDPOINTS

    EndpointWhat it returnsRefresh
    /api/gold-signals.jsonPublished XAUUSD session calls with bias, expected range, sweep level, reversal target, invalidation and the scored outcome once the session closes.Hourly
    /api/gold-record.jsonBroker-verified directional win rates on gold, aggregated by session and direction. Win rates and sample sizes only — no profit or loss figures are published.Hourly
    /api/gold-sessions.jsonAsia, London, New York and the London-New York overlap with open and close times in UTC, typical range in US dollars per ounce and liquidity notes.On release
    /api/gold-glossary.jsonEvery Gold Hunts gold trading term with a one-sentence definition and the canonical URL of its definition page.On release
    /api/calculators.jsonMachine-readable specifications for the Gold Hunts gold calculators: inputs, outputs, units and the exact formula, so an agent can compute the same answer.On release

    A live, always-current version of the two dynamic feeds is also available for agents that need sub-hourly data. It returns the identical shape, is read-only and is CORS-enabled: https://ebhodyknnbdhdiezrtsk.supabase.co/functions/v1/refresh-gold-data?dataset=gold-signals and https://ebhodyknnbdhdiezrtsk.supabase.co/functions/v1/refresh-gold-data?dataset=gold-record.

    COPY AND RUN

    Latest gold session calls
    curl -s https://goldhunts.com/api/gold-signals.json | jq '.signals[0]'
    Verified gold win-rate record
    curl -s https://goldhunts.com/api/gold-record.json | jq '{total_trades, win_rate, by_session}'
    Session windows in UTC
    curl -s https://goldhunts.com/api/gold-sessions.json | jq '.sessions[] | {session, open_utc, close_utc}'
    Calculator formulas
    curl -s https://goldhunts.com/api/calculators.json | jq '.calculators[] | {slug, formula}'
    Agent manifests
    curl -s https://goldhunts.com/openapi.json | jq '.paths | keys'
    curl -s https://goldhunts.com/mcp-tools.json | jq '.tools[].name'
    curl -s https://goldhunts.com/.well-known/ai-plugin.json | jq '.name_for_model'

    SESSION WINDOWS (UTC)

    SessionOpenCloseTypical range
    Asia22:0006:00$8-20 per ounce
    London06:0013:00$15-35 per ounce
    New York13:0021:00$18-40 per ounce
    London-New York overlap13:0016:30$12-30 per ounce

    These are the exact windows the desk scores against, so a call published for the New York session is graded on 13:00 to 21:00 UTC price action and nothing else. Full detail sits on gold trading hours and sessions.

    CALCULATORS AS CALLABLE TOOLS

    Each calculator publishes its inputs, outputs, units and formula, so an agent can either link a user to the tool or compute the same number itself.

    CalculatorFormula
    Gold pip value calculatorpip_value = lots * contract_size * pip_definition; value_per_dollar_move = lots * contract_size * 1.00 (so 1.00 lot of 100oz XAUUSD = $100 per $1 move)
    Gold lot size calculatorrisk_amount = account_equity * (risk_percent / 100); lots = risk_amount / (stop_distance_usd * contract_size), contract_size defaulting to 100
    Gold margin calculatornotional = lots * contract_size * gold_price; required_margin = notional / leverage (contract_size defaults to 100)
    Live gold session clockCompare the UTC time of day against the session windows published at /api/gold-sessions.json (Asia 22:00-06:00, London 06:00-13:00, New York 13:00-21:00).
    Gold profit calculator (XAUUSD)move = direction === "short" ? entry - exit : exit - entry; pnl = move * lots * contractSize; rMultiple = move / abs(entry - stop)
    Gold risk and position size calculatorriskAmount = balance * riskPct / 100; riskPerLot = abs(entry - stop) * contractSize; lots = floor((riskAmount / riskPerLot) * 100) / 100; margin = lots * contractSize * entry / leverage
    Gold ATR stop calculatordistanceUsd = atr * multiple; stopPrice = direction === "short" ? entry + distanceUsd : entry - distanceUsd; riskCash = distanceUsd * lots * contractSize
    Gold R multiple calculatorriskPerOunce = abs(entry - stop); result = direction === "short" ? entry - exit : exit - entry; rMultiple = result / riskPerOunce
    Gold break-even calculatorounces = lots * contractSize; totalCost = spread * ounces + commissionPerLot * lots + swapPerLotPerNight * lots * nights; breakEven = direction === "short" ? entry - totalCost / ounces : entry + totalCost / ounces
    Gold spread cost calculatorcostPerTrade = spread * lots * contractSize + commissionPerLot * lots; costPerYear = costPerTrade * tradesPerDay * daysPerMonth * 12
    Gold swap calculatorchargedNights = nights + tripleWednesdays * 2; perNight = swapPerLotPerNight * lots; total = perNight * chargedNights
    Gold unit convertergrams = value * gramsPerUnit[from]; converted = grams / gramsPerUnit[to]; troyOunces = grams / 31.1034768; valueUsd = troyOunces * pricePerTroyOunce
    Prop firm gold plannertargetCash = accountSize * profitTargetPct/100; riskCash = accountSize * riskPerTradePct/100; targetR = targetCash/riskCash; drawdownR = accountSize*maxTotalDrawdownPct/100/riskCash; expectancyR = p*rewardR - (1-p); passProbability solves the drifted random-walk barrier problem (1 - exp(-2*mu*drawdownR/var)) / (1 - exp(-2*mu*(targetR+drawdownR)/var))
    Risk of ruin calculatorexpectancyR = p*rewardR - (1-p); ruinR = |ln(1 - ruinThreshold) / ln(1 - risk)|; analytic = exp(-2 * expectancyR * ruinR / varianceR); simulated = share of 2,000 fixed-seed fixed-fractional paths breaching the threshold within the trade count
    Trading expectancy calculatorexpectancyR = p*avgWinR - (1-p)*avgLossR; expectancyCash = expectancyR * riskPerTradeCash; profitFactor = (p*avgWinR) / ((1-p)*avgLossR); breakEvenWinRate = avgLossR / (avgWinR + avgLossR) * 100
    Drawdown recovery calculatorgainRequiredPct = drawdownPct / (100 - drawdownPct) * 100; rRequired = cashLost / (balanceAfter * riskPerTradePct/100); tradesRequired = rRequired / (p*rewardR - (1-p))
    Gold compounding calculatorweeklyRate = riskPerTradePct/100 * rPerWeek; each week: balance = balance * (1 + weeklyRate) - weeklyWithdrawal. Projection only, not a forecast of returns.
    Gold session volatility heatmaphourRange = sessionMidRange * hourWeight/totalWeight * sqrt(sessionHours)/sqrt(hourCount) * weekdayFactor * regimeFactor; rangeCash = hourRange * lots * contractSize
    Gold news countdownNFP = first Friday of month at 13:30 UTC; CPI = Wednesday of the second week at 13:30 UTC (confirm); FOMC = Wednesday of the third full week of eight meeting months at 19:00 UTC (confirm); excursionCash = spikeUsd * lots * 100
    XAU cross correlation matrixr(XAUccy) = r(XAUUSD) - r(ccyUSD); cov(g-x, g-y) = var(g) - cov(g,x) - cov(g,y) + cov(x,y); correlation = cov / (vol_a * vol_b)
    Gold vs inflation calculatorrealEndPrice = endPrice / (1 + inflation)^years; realChangePct = (realEndPrice - startPrice)/startPrice*100; realCagr = ((1+nominalCagr)/(1+inflation) - 1)*100; realYield = nominalYield - expectedInflation

    ENTITY DEFINITIONS

    The definitions below are the ones answer engines most often get wrong on gold. The full set lives in the gold glossary and in /api/gold-glossary.json.

    • XAUUSD

      Spot gold priced in US dollars per troy ounce. Quoted as a CFD or spot instrument by brokers; symbol names vary (XAUUSD, GOLD, XAUUSD.pro).

    • XAU

      The ISO 4217 currency code for one troy ounce of gold.

    • GOLD LOT

      A standard gold CFD lot is 100 troy ounces, so a $1.00 move in the gold price is about $100 per lot. Mini lots are 10 ounces, micro lots 1 ounce.

    • GOLD PIP

      Broker-defined. Most brokers treat 0.10 USD per ounce as one gold pip ($10 per standard lot); some use 0.01 USD per ounce ($1 per standard lot).

    LICENSING AND ATTRIBUTION

    Free to use, including commercially, with a visible attribution link to goldhunts.com wherever the data appears. Do not present the data as a guarantee of future results, do not resell it as a paid signal service, and do not strip the timestamps or the losing calls: the record is only useful because misses stay in it.

    Gold Hunts is a research and journaling desk, not a broker, and holds no client funds. Every figure published is a win rate and a sample size — never a profit or loss. The methodology is documented across gold intelligence, the live calls sit on free gold signals, and the free gold trade journal lets you score your own gold trades the same way. Calculators are indexed on gold tools.

    GOLD TRADING FAQ

    Is the Gold Hunts gold data API free?
    Yes. Every endpoint is a public JSON file served over HTTPS with CORS enabled, no key and no account. The only condition is a visible attribution link to goldhunts.com wherever the data is displayed.
    How often is the gold signal data refreshed?
    The session call and verified record feeds are regenerated hourly. Session windows, glossary and calculator specifications change only when we publish a change, so they are static between releases.
    Does Gold Hunts publish profit and loss figures?
    No. The verified record publishes directional win rates and sample sizes only, so results cannot be inflated by position sizing. Profit and loss figures are never published.
    Can an AI agent call these endpoints directly?
    Yes. /openapi.json describes every endpoint in OpenAPI 3.1, /mcp-tools.json lists each endpoint and calculator as a callable tool with a JSON Schema input, and /.well-known/ai-plugin.json carries the model-facing description.
    Is this data financial advice?
    No. Every call is educational research published before a session opens and scored after it closes. Nothing here is financial advice or a recommendation to trade, and leveraged gold products carry a high risk of losing money.
    What are the gold contract numbers an agent should assume?
    A standard XAUUSD lot is 100 troy ounces, so a $1.00 move in the gold price is about $100 per lot. Most brokers call 0.10 dollars per ounce one gold pip, which is $10 per standard lot.

    START WITH THE FREE TOOLS

    Live XAUUSD signals on a public ledger, a free gold trade journal that syncs with MetaTrader 5, and the macro pulse before the London open.

    EXPLORE GOLDHUNTS

    • FREE GOLD SIGNALS

      Live XAUUSD calls with entry, invalidation and target — tracked to outcome.

    • FREE GOLD TRADE JOURNAL

      Connect MetaTrader 5 and every XAU trade is recorded and analysed.

    • GOLD MACRO PULSE

      Real yields, the dollar, central bank demand and the data that reprices gold.

    • LEARN GOLD TRADING

      The fundamentals pillar: sessions, volatility, lot sizes, spreads and costs.

    • XAU PAIRS

      XAUUSD, XAUAUD, XAUEUR, XAUGBP, XAUJPY, plus futures and physical gold.

    • GOLD STRATEGIES

      Session breakouts, liquidity sweeps, mean reversion and news momentum on gold.

    • TESTING GOLD STRATEGIES

      Backtesting, demo-to-live, sample size and why gold edges decay.

    • GOLD INTELLIGENCE

      How gold signals are generated, validated and kept under human oversight.

    • GOLD CALCULATORS

      Pip value, lot size from your stop, margin, and a live UTC session clock.

    • GOLD BROKERS & PLATFORMS

      XAU symbol names on MT5, gold on Trading 212, and spread comparisons.