---
title: "COMEX stocks and flows by depository"
method: GET
path: "/v1/comex/depositories"
tags: ["Regional"]
---

# COMEX stocks and flows by depository

`GET /v1/comex/depositories`

## Request

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

Daily COMEX warehouse stocks and flows per depository, laid out like CME's metal depository statistics report: for registered, eligible and total metal, the previous stock, received, withdrawn, net change, adjustment and today's stock. Rows are per report date, with activityDate giving the business day the movements happened. Received, withdrawn and adjustment are null on report dates before flowsAvailableFrom; stocks go back to February 2026 for most metals. Use /v1/comex/inventory for the exchange-wide totals, which go back to 1992 for gold and silver. Requires the Pro plan or higher.

## Query parameters

- `symbol` string, required: Required. Metal symbol: XAU, XAG, HG, XPT, XPD, ALI, ZN or PB.
- `range` string: One of 1M, 3M, 6M, 1Y, 5Y or ALL. Defaults to 1M. ALL returns the whole series, and MAX is accepted as a synonym for it. Ignored when start or end is given.
- `start` string: First report date, YYYY-MM-DD.
- `end` string: Last report date, YYYY-MM-DD. Defaults to today.
- `depository` string: Case-insensitive part of a depository name, e.g. jp morgan, brink or hsbc.

## Response `200`

Success.

- object
  - `success` boolean, required
  - `symbol` string, required
  - `unit` string: troy_ounces, short_tons or metric_tons.
  - `range` string
  - `start` string, date
  - `end` string, date, required
  - `flowsAvailableFrom` string, date: First report date with received, withdrawn and adjustment figures for this symbol.
  - `asOf` string, date
  - `ageDays` number
  - `stale` boolean, required
  - `count` number, required
  - `data` object[], required
    - `date` string, date, required: CME report date.
    - `activityDate` string, date: Business day the movements happened on; CME reports them the next business day.
    - `depository` string, required
    - `registered` object, required
      - `previous` number: PREV TOTAL: stock at the previous report.
      - `received` number: RECEIVED: metal delivered into the depository.
      - `withdrawn` number: WITHDRAWN: metal taken out of the depository.
      - `netChange` number: NET CHANGE: received minus withdrawn.
      - `adjustment` number: ADJUSTMENT: mostly transfers between registered and eligible.
      - `today` number: TOTAL TODAY: stock after the day's activity.
    - `eligible` object, required
      - `previous` number: PREV TOTAL: stock at the previous report.
      - `received` number: RECEIVED: metal delivered into the depository.
      - `withdrawn` number: WITHDRAWN: metal taken out of the depository.
      - `netChange` number: NET CHANGE: received minus withdrawn.
      - `adjustment` number: ADJUSTMENT: mostly transfers between registered and eligible.
      - `today` number: TOTAL TODAY: stock after the day's activity.
    - `total` object, required
      - `previous` number: PREV TOTAL: stock at the previous report.
      - `received` number: RECEIVED: metal delivered into the depository.
      - `withdrawn` number: WITHDRAWN: metal taken out of the depository.
      - `netChange` number: NET CHANGE: received minus withdrawn.
      - `adjustment` number: ADJUSTMENT: mostly transfers between registered and eligible.
      - `today` number: TOTAL TODAY: stock after the day's activity.

## 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)