# The Vault Report – Gold Squeeze Brief

> The Vault Report – Gold Squeeze Brief is a paid API for AI agents from thevaultreport.com, paid per call via x402, $2/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://thevaultreport.com/api/x402/squeeze-brief/gold
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/the-vault-report-gold-squeeze-brief-14a1f148
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SHnfSnXUPlEUTwOOWwYv9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability the-vault-report-gold-squeeze-brief-14a1f148
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Real-time COMEX and LME warehouse inventory, COT positioning, EIA oil data, and ETF flows. Physical-market intelligence the paper market ignores.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-vault-report-gold-squeeze-brief-14a1f148/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from thevaultreport.com](https://www.zero.xyz/host/thevaultreport.com/llms.txt)