{"uid":"cap_SHnfSnXUPlEUTwOOWwYv9","slug":"the-vault-report-gold-squeeze-brief-14a1f148","name":"The Vault Report – Gold Squeeze Brief","description":"Real-time COMEX and LME warehouse inventory, COT positioning, EIA oil data, and ETF flows. Physical-market intelligence the paper market ignores.","url":"https://thevaultreport.com/api/x402/squeeze-brief/gold","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"metal":"gold","source":"The Vault Report","sections":{"premiums":{"flag":"neutral","rows":[],"venues":3,"readout":"Ex-tax physical gold premium averages +0.6% over COMEX across 3 venue(s) — physical is near fair value vs COMEX.","avg_ex_tax_premium_pct":0.6},"anomalies":{"top":[],"flag":"neutral","count":3,"readout":"3 gold-linked series on the abnormality board; most abnormal: COMEX registered gold (score 2.40)."},"lme_stocks":{"flag":"unavailable","readout":"The LME lists copper only among these metals; no LME stock series for gold."},"cot_managed_money":{"flag":"tightening","readout":"Managed-money net gold sits at the 88th percentile of its record — positioning is crowded long (squeeze-prone).","percentile":0.88,"managed_money_net":210000},"comex_deliveries_pace":{"flag":"tightening","readout":"Latest month 2026-04 delivered 1250000 oz, 1.42x the prior-6-month median (880000 oz) — delivery pace accelerating.","latest_month":"2026-04","prior_median_oz":880000,"ratio_vs_median":1.42,"prior_months_used":6,"latest_delivered_oz":1250000},"comex_registered_eligible":{"flag":"tightening","as_of":"2026-04-17","readout":"Gold registered/eligible stocks (11.2M oz sitting at the 8th percentile of its record) — deliverable metal is scarce.","total_qty":31000000,"percentile":0.08,"eligible_qty":19800000,"change_30d_pct":-4.1,"registered_qty":11200000}},"generated_at":"2026-04-18T14:00:00Z","schema_version":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qgjjIEXnjbeX6JGJZfHbh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a consolidated physical-market intelligence snapshot for gold, bundling COMEX delivery pace, registered/eligible inventory, COT managed-money positioning, physical premiums, and anomaly flags into a single squeeze-risk brief.","exampleAgentPrompt":"Pull the Vault Report gold squeeze brief and tell me whether physical gold is tight — I want to see COMEX registered inventory percentile, delivery pace vs the prior 6-month median, managed-money COT positioning percentile, and any squeeze flags.","exampleUseCases":[{"title":"Pre-trade squeeze risk check","prompt":"Before I add to my gold futures position, check the Vault Report gold squeeze brief and tell me if managed-money is crowded long and whether COMEX deliverable stock is historically low — I need the percentile on both."},{"title":"Daily commodity desk morning briefing","prompt":"Give me this morning's gold physical-market snapshot from the Vault Report: COMEX registered and eligible inventory with 30-day change, delivery pace ratio vs the prior 6-month median, and whether any squeeze flags are active."},{"title":"Physical premium arbitrage monitoring","prompt":"Check the Vault Report gold squeeze brief and tell me the average ex-tax physical premium over COMEX right now, how many venues are covered, and what the overall premium flag is — I'm watching for dislocations between paper and physical prices."}],"resultDescription":"A JSON object with a 'sections' map covering: physical premiums (flag, average ex-tax premium %, venue count, readout), anomalies (flag, count, top anomaly with score), LME stock status (availability flag, readout), COT managed-money net position (percentile, net contracts, tightening flag), COMEX delivery pace (latest month oz, prior median oz, ratio vs median, flag), and COMEX registered/eligible stocks (registered oz, eligible oz, total oz, 30-day change %, percentile, as-of date, flag). Each section includes a plain-English readout string and a flag (neutral / tightening / unavailable).","failureModes":["Stale data: COMEX or COT source feed not yet updated for the current session — generated_at timestamp may lag by hours","LME section unavailable: gold has no LME stock series; flag returns 'unavailable' by design","Payment failure: $2 USDC x402 payment not accepted, returns 402 Payment Required","Malformed input: no query parameters required but unexpected keys may be ignored silently","Data gap: anomalies section may return empty top array if no significant anomalies detected"],"whenToPreferThis":"Choose this endpoint when you need a single-call, pre-digested physical-market squeeze risk brief for gold that combines COMEX inventory levels, delivery pace, COT positioning, and cash premiums — saving you from stitching together CFTC, COMEX, and spot data yourself. Prefer it over generic commodity data APIs when the specific question is about physical tightness, short-squeeze risk, or paper-vs-physical dislocation in gold.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:09.489Z","isFirstParty":false}