The Vault Report

Endpoints (16 live)

• GET /api/x402/comex/warehouse — COMEX warehouse inventory: registered, eligible and total levels plus the per-depository breakdown, by metal and date. Quantities are in CME's reporting unit per metal: troy ounces for gold/silver/platinum/palladium, SHORT TONS for copper, metric tonnes for aluminum/zinc/lead. Extracted from CME's daily warehouse PDFs. (0.01 USDC on Base)
• GET /api/x402/premiums — Physical premiums with tax-wedge decomposition: for each venue (Shanghai/Tokyo/India/London) the gross premium over COMEX, the embedded import-duty/VAT/consumption-tax wedge, and the ex-tax 'market' premium — the real physical-demand signal after stripping tax distortion. Optional ?metal=gold|silver|platinum|palladium. (0.02 USDC on Base)
• GET /api/x402/comex/deliveries — COMEX daily delivery notices: issues and stops with the house-vs-customer split, per CME product and contract month. Read from CME's daily Issues and Stops report and reconciled against its own printed totals. Contract counts are per product, so never sum across product_code -- a micro contract is a tenth or a fifth of the standard one. ounces_issued/ounces_stopped are NULL for copper and aluminium, which are not priced in ounces. (0.01 USDC on Base)
• GET /api/x402/cot/positioning — CFTC Commitments of Traders — weekly disaggregated futures positioning by commodity: managed-money long/short/net, producer-merchant, swap-dealer, and open interest. 20-year history, cleaned and canonicalized from the CFTC feed. Filter by commodity (gold/silver/copper/platinum/palladium/wti_crude). (0.01 USDC on Base)
• GET /api/x402/squeeze-brief/gold — 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. (2 USDC on Base)
• GET /api/x402/feature-request/42/upvote — Upvote an existing feature request by id, so the requests real paying agents care about rise to the top of the free roadmap list. One cent per vote — the price is what makes a vote mean something. Path param :id (the integer id returned when a request is filed). (0.01 USDC on Base)
• GET /api/x402/anomalies — Ranked market anomalies: every tracked precious-metals and energy series scored by how far its latest reading sits from its own history — a composite of level extremity, 30-day z-score, and move velocity — sorted most-abnormal-first with record context. One call returns a scored anomaly watchlist that the free /snapshot omits. Optional ?limit=N for the top-N. (0.02 USDC on Base)
• GET /api/x402/lme/warehouse — LME warehouse stocks by metal and date: total tonnes per metal, 18-year daily history back to 2008. Total stock is present on every row; the source publishes no on/off-warrant split. cash_price and three_month_price only on the most recent ~550 rows, because the historical backfill carried stock levels alone. (0.01 USDC on Base)
• GET /api/x402/oil/inventory — EIA weekly US oil series. Stock series (SPR, CUSHING, COMMERCIAL_CRUDE_US, GASOLINE_*, DISTILLATE_* incl ULSD/sulfur grades, JET_*) are levels in thousand barrels. TOTAL_PRODUCTS_US is TOTAL US stocks of crude PLUS products INCLUDING the SPR (WTTSTUS1). Native units in the same column: *_PRODUCTION/IMPORTS/EXPORTS/DEMAND_US kbbl PER DAY; REFINERY_UTILIZATION_US PERCENT; *_DAYS_SUPPLY_US DAYS; DIESEL_RETAIL_PRICE_US USD PER GALLON, Monday-dated. Filter by series. Source: EIA WPSR. (0.01 USDC on Base)
• GET /api/x402/squeeze-brief/1 — 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. (2 USDC on Base)
• GET /api/x402/oil/production — JODI monthly oil balances by country: production, refinery output/intake and closing stocks, per product (CRUDEOIL, GASOLINE, JETKERO, …) and flow (INDPROD, REFGROUT, REFINOBS, CLOSTLV). Each row's unit column names its unit: KBD (thousand barrels per day) for the rate flows, KBBL (thousand barrels) for CLOSTLV stock levels. Crude production = product_code CRUDEOIL + flow_code INDPROD. Filter by country. Source: the Joint Organisations Data Initiative. (0.01 USDC on Base)
• GET /api/x402/mint/dataset — Full US Mint bullion-coin sales dataset: per-metal monthly one-ounce coin counts (combined American Eagle + Buffalo gold, American Eagle silver) back to the 1986 launch — one row per month (report_month, gold_1oz_coins, silver_1oz_coins), ascending. Each count is units AND troy ounces at once. Same dataset as the $9 CSV, delivered as JSON. Optional from/to (YYYY-MM-DD) narrow the window; omit for the full history. Source: usmint.gov. (9 USDC on Base)
• GET /api/x402/feature-request — File a feature request against The Vault Report's data API: tell us which precious-metals, COMEX or LME series you wish existed and can't get. One cent per request — the price is a spam gate, not revenue, so the demand signal is real. Query param ?text= (max 1000 characters). Reading the resulting roadmap is free at /api/x402/feature-requests. (0.01 USDC on Base)
• GET /api/x402/comex/flows — COMEX daily vault flows: metal received into and withdrawn from the COMEX depositories per metal and date — the in/out movement behind the registered/eligible levels. Same per-metal units as the warehouse endpoint: troy ounces for gold/silver/platinum/palladium, short tons for copper, metric tonnes for aluminum/zinc/lead. Extracted from CME's daily warehouse PDFs. (0.01 USDC on Base)
• GET /api/x402/feature-request/1/upvote — Upvote an existing feature request by id, so the requests real paying agents care about rise to the top of the free roadmap list. One cent per vote — the price is what makes a vote mean something. Path param :id (the integer id returned when a request is filed). (0.01 USDC on Base)
• GET /api/x402/asia/retail-prices — Asian retail precious-metal prices: the physical over-the-counter price retail buyers actually pay in Taiwan (Bank of Taiwan gold passbook), Japan (Tanaka: gold, platinum, silver) and India (IBJA: gold, silver) — one row per venue/metal. Rows carry price_local/currency/unit plus price_usd_per_oz where published (null for Taiwan); contract splits Taiwan's buy/sell legs. Optional ?metal=gold|silver|platinum. Retail only — LBMA/SHFE/COMEX excluded. (0.01 USDC on Base)