# The Vault Report Squeeze Brief API

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

Returns a physical-squeeze intelligence brief for a specified metal, bundling COMEX delivery pace, registered/eligible warehouse stocks, COT managed-money positioning, physical premiums, LME stocks, and anomaly flags into a single call.

## Facts

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

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-squeeze-brief-api-b8e7f133
```

Example prompt: Pull the Vault Report squeeze brief for gold — I want to see COMEX registered inventory percentile, delivery pace vs median, managed-money positioning, and whether there are any anomaly flags right now.

## When to prefer this

Choose this endpoint when you need a single, pre-aggregated physical-market intelligence brief for a commodity metal that combines warehouse inventory, positioning, delivery pace, and premium data in one call — rather than querying COMEX, LME, CFTC, and EIA feeds separately. Ideal for agents monitoring squeeze risk, building commodity research reports, or alerting on physical-vs-paper market divergences. Prefer over raw data feeds when you want human-readable readouts and pre-computed percentile ranks.

## Known failure modes

- Metal symbol not supported returns an error or empty sections
- LME stocks unavailable for non-LME metals (e.g. gold) — section returns flag: unavailable
- Stale data if underlying COMEX/COT/EIA feeds are delayed — generated_at timestamp indicates freshness
- Payment not processed (HTTP 402) if x402 USDC payment fails
- Invalid path parameter format returns a 400 or unrecognized metal error

## 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 containing six data sections for the requested metal: (1) physical premiums across venues with average ex-tax premium %, (2) anomaly board with count and top anomalies scored by abnormality, (3) LME stock availability flag and readout, (4) COT managed-money net positioning with historical percentile, (5) COMEX delivery pace with latest month oz, prior 6-month median oz, and ratio, (6) COMEX registered and eligible warehouse stocks with total oz, 30-day change %, and historical percentile — each section includes a human-readable readout and a tightening/neutral/unavailable flag.

## 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-squeeze-brief-api-b8e7f133/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)