{"uid":"cap_I87NTGHkpIZ57-IwLTn2x","slug":"the-vault-report-physical-squeeze-brief-e13af48c","name":"The Vault Report – Physical Squeeze Brief","description":"Physical-squeeze brief for one metal: a single call bundling COMEX delivery pace, registered/eligible warehouse levels, LME stocks, managed-money positioning, live board anomalies, and tax-adjusted physical premiums — each section tagged tightening/neutral/loosening with a plain-English readout. The interpreted answer to 'is the physical market for gold/silver/copper/platinum tightening right now, and why?' Path param :metal ∈ gold|silver|copper|platinum.","url":"https://thevaultreport.com/api/x402/squeeze-brief/:metal","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["metal"],"properties":{"metal":{"enum":["gold","silver","copper","platinum"],"type":"string"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"metal":{"type":"string"},"sections":{"type":"object","properties":{"premiums":{"type":"object","properties":{"flag":{"enum":["tightening","neutral","loosening","unavailable"],"type":"string"},"readout":{"type":"string"}},"description":"One market slice, tagged with a tightening/neutral/loosening/unavailable flag plus a one-line plain-English readout and section-specific numeric fields."},"anomalies":{"type":"object","properties":{"flag":{"enum":["tightening","neutral","loosening","unavailable"],"type":"string"},"readout":{"type":"string"}},"description":"One market slice, tagged with a tightening/neutral/loosening/unavailable flag plus a one-line plain-English readout and section-specific numeric fields."},"lme_stocks":{"type":"object","properties":{"flag":{"enum":["tightening","neutral","loosening","unavailable"],"type":"string"},"readout":{"type":"string"}},"description":"One market slice, tagged with a tightening/neutral/loosening/unavailable flag plus a one-line plain-English readout and section-specific numeric fields."},"cot_managed_money":{"type":"object","properties":{"flag":{"enum":["tightening","neutral","loosening","unavailable"],"type":"string"},"readout":{"type":"string"}},"description":"One market slice, tagged with a tightening/neutral/loosening/unavailable flag plus a one-line plain-English readout and section-specific numeric fields."},"comex_deliveries_pace":{"type":"object","properties":{"flag":{"enum":["tightening","neutral","loosening","unavailable"],"type":"string"},"readout":{"type":"string"}},"description":"One market slice, tagged with a tightening/neutral/loosening/unavailable flag plus a one-line plain-English readout and section-specific numeric fields."},"comex_registered_eligible":{"type":"object","properties":{"flag":{"enum":["tightening","neutral","loosening","unavailable"],"type":"string"},"readout":{"type":"string"}},"description":"One market slice, tagged with a tightening/neutral/loosening/unavailable flag plus a one-line plain-English readout and section-specific numeric fields."}}},"generated_at":{"type":"string","format":"date-time"},"schema_version":{"type":"integer"}}}}}}},"responseSchema":null,"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_M0ybrsaWxEqyn0nEJ-9cC","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 bundled physical-market tightness report for a single metal (gold, silver, copper, or platinum), synthesizing COMEX deliveries, warehouse levels, LME stocks, managed-money positioning, board anomalies, and tax-adjusted premiums into plain-English tightening/neutral/loosening signals.","exampleAgentPrompt":"Pull the full physical squeeze brief for gold — I want to know if the market is tightening right now, with the COMEX delivery pace, warehouse levels, LME stocks, positioning, and premium signals all in one place.","exampleUseCases":null,"resultDescription":"A structured JSON object with a section for each market dimension (COMEX delivery pace, warehouse registered/eligible levels, LME stocks, managed-money COT positioning, board anomalies, physical premiums), each tagged with a tightening/neutral/loosening/unavailable flag and a one-line plain-English readout, plus section-specific numeric fields — all for the requested metal.","failureModes":["Invalid metal path param (not in gold|silver|copper|platinum) — likely 400 or 404 error","Upstream data source unavailable for a section — that section returns flag: 'unavailable' with a note","Payment not completed via x402 protocol — 402 Payment Required returned before data is served","Rate limiting or quota exceeded — 429 response","Network timeout if upstream market data feeds are slow"],"whenToPreferThis":"Choose this endpoint when you need a single, pre-interpreted, multi-source physical market tightness verdict for one metal rather than assembling raw data from separate COMEX, LME, COT, or premium endpoints yourself. It is ideal for agentic workflows that need a fast, opinionated answer ('is this metal squeezing?') with supporting evidence, rather than raw numeric feeds. Use it over sibling endpoints when breadth-of-signal matters more than depth on any single data dimension.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:35:50.226Z","isFirstParty":false}