---
title: "COMEX warehouse inventory"
method: GET
path: "/v1/comex/inventory"
tags: ["Regional"]
---

# COMEX warehouse inventory

`GET /v1/comex/inventory`

## Request

- Base URL: `https://api.metalcharts.org`
- URL: `https://api.metalcharts.org/v1/comex/inventory`
- Auth: none declared

COMEX warehouse inventory history for a metal symbol: exchange-wide registered, eligible and total per day. type=latest returns the newest day with the previous day's figures; type=depositories returns the newest day per depository, with that day's received, withdrawn and adjustment figures. For per-depository history use /v1/comex/depositories. Requires the Pro plan or higher. Every response carries asOf, ageDays and a stale flag, so you can tell a current series from one that has stopped updating without inspecting the array.

## Query parameters

- `symbol` string, required: Required. Metal symbol: XAU, XAG, HG, XPT, XPD, ALI, ZN or PB (availability varies by endpoint).
- `range` string: One of 1M, 3M, 6M, 1Y, 5Y or ALL. Defaults to 1Y. ALL returns the whole series, and MAX is accepted as a synonym for it.
- `type` string

## Response `200`

Success.

- object
  - `success` boolean, required
  - `symbol` string
  - `range` string
  - `asOf` string, date
  - `ageDays` number
  - `stale` boolean
  - `count` number
  - `data` object[], required
    - `date` string, date
    - `eligible` number
    - `registered` number
    - `total` number

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/metalcharts/apis/metalcharts-api.md) · [All operations](https://skmtc.dev/metalcharts/apis/metalcharts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metalcharts/apis/metalcharts-api/revisions/53d6a0af0479?raw)