{"uid":"cap_zhyixz4sNtWQt6200Akos","slug":"the-vault-report-squeeze-brief-api-b8e7f133","name":"The Vault Report Squeeze Brief API","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/%7Bmetal%7D","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_yE6Ll5TMxOdzNdV31titX","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 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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Gold short-squeeze risk assessment","prompt":"Can you check whether gold is at risk of a physical short squeeze? I want to see the COMEX registered inventory percentile, how fast deliveries are running versus the 6-month median, and how crowded managed-money longs are."},{"title":"Silver physical premium monitoring","prompt":"What are the physical premiums on silver across COMEX venues right now, and is the registered inventory tight? Pull the Vault Report squeeze brief for silver."},{"title":"Copper LME and COMEX cross-market check","prompt":"Get me the Vault Report squeeze brief for copper — I need to see LME stock status, COMEX delivery pace, and any anomaly flags to decide whether the paper price is disconnected from physical supply."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:02.201Z","isFirstParty":false}