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
| Endpoint | What it returns | Refresh |
|---|---|---|
| /api/gold-signals.json | Published XAUUSD session calls with bias, expected range, sweep level, reversal target, invalidation and the scored outcome once the session closes. | Hourly |
| /api/gold-record.json | Broker-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.json | Asia, 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.json | Every Gold Hunts gold trading term with a one-sentence definition and the canonical URL of its definition page. | On release |
| /api/calculators.json | Machine-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
curl -s https://goldhunts.com/api/gold-signals.json | jq '.signals[0]'curl -s https://goldhunts.com/api/gold-record.json | jq '{total_trades, win_rate, by_session}'curl -s https://goldhunts.com/api/gold-sessions.json | jq '.sessions[] | {session, open_utc, close_utc}'curl -s https://goldhunts.com/api/calculators.json | jq '.calculators[] | {slug, formula}'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)
| Session | Open | Close | Typical range |
|---|---|---|---|
| Asia | 22:00 | 06:00 | $8-20 per ounce |
| London | 06:00 | 13:00 | $15-35 per ounce |
| New York | 13:00 | 21:00 | $18-40 per ounce |
| London-New York overlap | 13:00 | 16: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.
| Calculator | Formula |
|---|---|
| Gold pip value calculator | pip_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 calculator | risk_amount = account_equity * (risk_percent / 100); lots = risk_amount / (stop_distance_usd * contract_size), contract_size defaulting to 100 |
| Gold margin calculator | notional = lots * contract_size * gold_price; required_margin = notional / leverage (contract_size defaults to 100) |
| Live gold session clock | Compare 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 calculator | riskAmount = balance * riskPct / 100; riskPerLot = abs(entry - stop) * contractSize; lots = floor((riskAmount / riskPerLot) * 100) / 100; margin = lots * contractSize * entry / leverage |
| Gold ATR stop calculator | distanceUsd = atr * multiple; stopPrice = direction === "short" ? entry + distanceUsd : entry - distanceUsd; riskCash = distanceUsd * lots * contractSize |
| Gold R multiple calculator | riskPerOunce = abs(entry - stop); result = direction === "short" ? entry - exit : exit - entry; rMultiple = result / riskPerOunce |
| Gold break-even calculator | ounces = lots * contractSize; totalCost = spread * ounces + commissionPerLot * lots + swapPerLotPerNight * lots * nights; breakEven = direction === "short" ? entry - totalCost / ounces : entry + totalCost / ounces |
| Gold spread cost calculator | costPerTrade = spread * lots * contractSize + commissionPerLot * lots; costPerYear = costPerTrade * tradesPerDay * daysPerMonth * 12 |
| Gold swap calculator | chargedNights = nights + tripleWednesdays * 2; perNight = swapPerLotPerNight * lots; total = perNight * chargedNights |
| Gold unit converter | grams = value * gramsPerUnit[from]; converted = grams / gramsPerUnit[to]; troyOunces = grams / 31.1034768; valueUsd = troyOunces * pricePerTroyOunce |
| Prop firm gold planner | targetCash = 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 calculator | expectancyR = 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 calculator | expectancyR = p*avgWinR - (1-p)*avgLossR; expectancyCash = expectancyR * riskPerTradeCash; profitFactor = (p*avgWinR) / ((1-p)*avgLossR); breakEvenWinRate = avgLossR / (avgWinR + avgLossR) * 100 |
| Drawdown recovery calculator | gainRequiredPct = drawdownPct / (100 - drawdownPct) * 100; rRequired = cashLost / (balanceAfter * riskPerTradePct/100); tradesRequired = rRequired / (p*rewardR - (1-p)) |
| Gold compounding calculator | weeklyRate = riskPerTradePct/100 * rPerWeek; each week: balance = balance * (1 + weeklyRate) - weeklyWithdrawal. Projection only, not a forecast of returns. |
| Gold session volatility heatmap | hourRange = sessionMidRange * hourWeight/totalWeight * sqrt(sessionHours)/sqrt(hourCount) * weekdayFactor * regimeFactor; rangeCash = hourRange * lots * contractSize |
| Gold news countdown | NFP = 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 matrix | r(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 calculator | realEndPrice = 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.