{"uid":"cap_53w3OQAqp8k-0AzcwZuc_","slug":"comex-warehouse-inventory-api-9763aed0","name":"COMEX Warehouse Inventory API","description":"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.","url":"https://thevaultreport.com/api/x402/comex/warehouse","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":{"to":{"type":"string","format":"date","example":"2026-04-30"},"from":{"type":"string","format":"date","example":"2026-01-01"},"page":{"type":"integer","default":1,"example":1,"minimum":1},"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","total_matches"],"properties":{"page":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"metal":{"type":"string"},"total_qty":{"type":"number"},"pledged_qty":{"type":"number"},"eligible_qty":{"type":"number"},"received_qty":{"type":"number"},"activity_date":{"type":"string","format":"date"},"withdrawn_qty":{"type":"number"},"registered_qty":{"type":"number"},"warehouse_breakdown":{"type":"object","properties":{"warehouses":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"eligible":{"type":"number"},"registered":{"type":"number"}}}}},"description":"Per-depository detail: {\"warehouses\": [{\"name\", \"registered\", \"eligible\", ...}]}."},"total_adjustment_qty":{"type":"number"},"eligible_adjustment_qty":{"type":"number"},"registered_adjustment_qty":{"type":"number"}}}},"source":{"type":"string"},"filters":{"type":"object","description":"Echo of the filters that were applied."},"license":{"type":"string"},"related":{"type":"array","items":{"type":"object"},"description":"Sibling endpoints worth buying next."},"endpoint":{"type":"string"},"returned":{"type":"integer"},"next_page":{"type":["integer","null"],"description":"Next page number, or null when this is the last page."},"page_size":{"type":"integer"},"source_url":{"type":"string"},"attribution":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"total_matches":{"type":"integer"},"schema_version":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"page":1,"rows":[{"metal":"GOLD","total_qty":11200000,"pledged_qty":11200000,"eligible_qty":11200000,"received_qty":11200000,"activity_date":"2026-04-17","withdrawn_qty":11200000,"adjustment_qty":11200000,"registered_qty":11200000,"warehouse_breakdown":{"Brink's":4210000,"JPMorgan":6990000}}],"source":"The Vault Report","filters":{"metal":"gold"},"license":"CC BY 4.0","related":[],"endpoint":"comex/warehouse","returned":1,"next_page":2,"page_size":25,"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","total_matches":1482,"schema_version":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xfZ7QuF3uISGuvr-i52bl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily COMEX warehouse inventory data (registered, eligible, total ounces) with per-depository breakdown, filterable by metal and date range.","exampleAgentPrompt":"Pull me the COMEX gold warehouse inventory data from January 1 2026 to April 30 2026, including the per-depository breakdown, so I can see how registered and eligible ounces have been trending.","exampleUseCases":null,"resultDescription":"A paginated list of rows each containing the activity date, metal, registered/eligible/total/pledged/received/withdrawn/adjustment quantities in ounces, and a warehouse_breakdown object keyed by depository name. Also returns pagination metadata (page, page_size, returned, next_page, total_matches), applied filters, source attribution, generated_at timestamp, and links to sibling endpoints.","failureModes":["Invalid date format returns validation error","Unsupported metal enum value returns 400","Date range with no data returns empty rows array","Pagination beyond last page returns null next_page","Payment not received (x402) blocks access","CME source PDF not yet processed for today's date may return stale or missing rows"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable COMEX warehouse inventory data — registered, eligible, and total ounces with depository-level detail — extracted from CME's official daily PDFs. Prefer this over scraping CME directly or using generic commodity data providers when you need historical date-range queries, per-warehouse breakdowns, or programmatic access to multiple metals in one interface.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:18.515Z","isFirstParty":false}