{"uid":"cap_Zfo0_IpEm3ndMMojqJsip","slug":"the-vault-report-physical-precious-metals-premiums-with-tax-wedge-ddc14ddb","name":"The Vault Report — Physical Precious Metals Premiums with Tax-Wedge Decomposition","description":"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.","url":"https://thevaultreport.com/api/x402/premiums","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"},"queryParams":{"type":"object","properties":{"metal":{"enum":["gold","silver","copper","platinum"],"type":"string","example":"gold"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["endpoint","rows"],"properties":{"note":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"unit":{"type":"string"},"as_of":{"type":"string","format":"date-time"},"metal":{"type":"string"},"venue":{"type":"string"},"source":{"type":"string"},"contract":{"type":"string"},"currency":{"type":"string"},"usd_per_oz":{"type":"number"},"local_price":{"type":"number"},"wedge_label":{"type":"string"},"tax_wedge_pct":{"type":"number"},"gross_premium_pct":{"type":"number"},"ex_tax_premium_pct":{"type":"number"},"comex_ref_usd_per_oz":{"type":"number"}}}},"source":{"type":"string"},"license":{"type":"string"},"endpoint":{"type":"string"},"returned":{"type":"integer"},"source_url":{"type":"string"},"attribution":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"schema_version":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"rows":[{"as_of":"2026-04-18","metal":"GOLD","venue":"Shanghai","source":"sina_shfe","price_usd_per_oz":3412.8,"gross_premium_pct":13.6,"ex_tax_premium_pct":0.6}],"source":"The Vault Report","license":"CC BY 4.0","endpoint":"premiums","returned":1,"source_url":"https://thevaultreport.com","attribution":"Attribute to The Vault Report with a link to https://thevaultreport.com","generated_at":"2026-04-18T14:00:00Z","schema_version":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WlyeXnGGMzbHsyV1yBRPJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns physical precious metal premiums over COMEX by venue (Shanghai, Tokyo, India, London), broken into gross premium, embedded tax wedge (import duty/VAT/consumption tax), and ex-tax market premium — isolating real physical demand from tax distortion.","exampleAgentPrompt":"Pull the physical gold premiums for all venues from The Vault Report and break out how much of each regional premium is due to import duties or VAT versus actual physical market demand.","exampleUseCases":[{"title":"Identify arbitrage opportunities across metal venues","prompt":"Check the ex-tax gold premiums across Shanghai, Tokyo, India, and London — I want to find where real physical demand is strongest after stripping out all the tax distortions."},{"title":"Analyze tax impact on regional precious metal pricing","prompt":"Get the silver premiums from The Vault Report for India and Japan, then show me how much of the difference is just consumption taxes versus genuine supply-demand tightness in those markets."},{"title":"Track genuine physical metal demand signals","prompt":"Pull the current physical palladium and platinum premiums across all venues and decompose them so I can see the tax wedge separately from the actual market premium — I need to understand true physical buying pressure."}],"resultDescription":"A JSON array of rows, one per venue per metal, each containing: venue name, metal, as-of timestamp, price in USD/oz, gross premium % over COMEX, and ex-tax (market) premium % after subtracting the embedded import-duty/VAT/consumption-tax wedge. Also includes source attribution, license info, and generation timestamp.","failureModes":["Invalid metal enum value returns a validation error","No data available for a specific venue/metal combination returns empty rows array","Upstream data source unavailability may return stale or missing timestamps","Network or payment authentication failure (x402) returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to distinguish genuine physical demand from tax-driven price distortions in international precious metals markets — especially when comparing premiums across jurisdictions with very different duty/VAT regimes (India import duty, Chinese VAT, Japanese consumption tax). Prefer this over generic spot-price APIs when the analytical goal is understanding cross-border arbitrage or real supply/demand pressure rather than just price levels.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:36:59.152Z","isFirstParty":false}