# COMEX Daily Delivery Notices API

> COMEX Daily Delivery Notices API is a paid API for AI agents from thevaultreport.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns COMEX daily delivery notices (issues and stops) with house-vs-customer splits, per contract month and metal, extracted from CME's official delivery PDFs.

## Facts

- Endpoint: GET https://thevaultreport.com/api/x402/comex/deliveries
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/comex-daily-delivery-notices-api-4e636247
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZLrJasQlbzxXvAYzBPaOt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability comex-daily-delivery-notices-api-4e636247
```

Example prompt: Pull the COMEX delivery notices for gold from January 1 to April 30 2026 — I want to see the daily issues and stops with the house vs customer breakdown by contract month.

## When to prefer this

Use this endpoint when you need granular daily COMEX delivery notice data broken down by house vs. customer accounts and by contract month. Prefer this over the physical-squeeze brief endpoint when you want raw delivery notice timeseries rather than a bundled analytical summary. Ideal for monitoring delivery pace, tracking cumulative stop/issue activity, or identifying positioning shifts between proprietary (house) and client (customer) accounts across gold, silver, copper, and platinum.

## Known failure modes

- Invalid metal enum value returns 400 validation error
- Date range with 'from' after 'to' returns empty results or error
- Page number beyond available pages returns empty rows with null next_page
- Missing or malformed date format returns schema validation error
- No data available for requested date range returns empty rows array with total_matches of 0

## How this service works

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.

## Output

A paginated JSON response containing rows of COMEX delivery notice records, each with activity date, metal, contract month, issues, stops, house/customer splits, ounces issued/stopped, cumulative totals, and open interest. Also includes filter echo, pagination metadata (page, page_size, returned, next_page, total_matches), source URL, attribution, and related sibling endpoints.

## Request schema (JSON Schema)

```json
{
 "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"
         },
         "stops": {
          "type": "number"
         },
         "issues": {
          "type": "number"
         },
         "house_stops": {
          "type": "number"
         },
         "house_issues": {
          "type": "number"
         },
         "product_code": {
          "type": "string"
         },
         "activity_date": {
          "type": "string",
          "format": "date"
         },
         "ounces_issued": {
          "type": "number"
         },
         "report_run_at": {
          "type": "number"
         },
         "contract_month": {
          "type": "string"
         },
         "customer_stops": {
          "type": "number"
         },
         "ounces_stopped": {
          "type": "number"
         },
         "customer_issues": {
          "type": "number"
         },
         "cumulative_issues": {
          "type": "number"
         }
        }
       }
      },
      "source": {
       "type": "string"
      },
      "filters": {
       "type": "object",
       "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "rows": [
   {
    "metal": "GOLD",
    "stops": 1250,
    "issues": 1250,
    "house_stops": 1250,
    "house_issues": 1250,
    "activity_date": "2026-04-17",
    "open_interest": 418200,
    "ounces_issued": 1250,
    "contract_month": "2026-06",
    "customer_stops": 1250,
    "ounces_stopped": 1250,
    "customer_issues": 1250,
    "cumulative_stops": 18400,
    "cumulative_issues": 18400
   }
  ],
  "source": "The Vault Report",
  "filters": {
   "metal": "gold"
  },
  "license": "CC BY 4.0",
  "related": [],
  "endpoint": "comex/deliveries",
  "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/comex-daily-delivery-notices-api-4e636247/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from thevaultreport.com](https://www.zero.xyz/host/thevaultreport.com/llms.txt)