# LME Warehouse Stocks API

> LME Warehouse Stocks 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 LME warehouse on-warrant, cancelled, and total tonnes with cash and 3-month prices by metal and date, with 18 years of daily history from 2008.

## Facts

- Endpoint: GET https://thevaultreport.com/api/x402/lme/warehouse
- 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/lme-warehouse-stocks-api-b6faf87e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vJ4163XHCSQVSJiRdyfwD

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 lme-warehouse-stocks-api-b6faf87e
```

Example prompt: Pull LME warehouse stock data for copper from January 1 2026 to April 30 2026 — I need the on-warrant, cancelled, and total tonnes along with the cash and 3-month prices, starting on page 1.

## When to prefer this

Use this endpoint when you need historical or current LME warehouse stock levels (on-warrant, cancelled, total tonnes) and LME cash/3-month price data for gold, silver, copper, or platinum. It is the best choice for analyzing LME inventory trends, warrant cancellation signals, or building commodity market intelligence tools that require granular daily warehouse data going back to 2008. Prefer this over COMEX endpoints for LME-specific inventory and pricing.

## Known failure modes

- Invalid metal enum value returns validation error
- Date format not ISO 8601 (YYYY-MM-DD) causes parse failure
- Date range with no data (pre-2008) returns empty rows
- Page number beyond last page returns empty result set
- Missing required query params may return all data or trigger pagination defaults
- Payment failure (x402) blocks access if USDC balance insufficient

## How this service works

LME warehouse stocks: on-warrant, cancelled and total tonnes with cash and 3-month prices, by metal and date. 18-year daily history back to 2008.

## Output

A paginated JSON response containing rows of daily LME warehouse data per metal, including on-warrant, cancelled, off-warrant, delivered-in and delivered-out quantities in tonnes, cash price, 3-month price, activity date, and a per-location depository breakdown. Also includes total match count, pagination metadata, source attribution, and related endpoint suggestions.

## 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"
         },
         "total_qty": {
          "type": "number"
         },
         "cash_price": {
          "type": "number"
         },
         "activity_date": {
          "type": "string",
          "format": "date"
         },
         "three_month_price": {
          "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": "i
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "rows": [
   {
    "metal": "GOLD",
    "total_qty": 11200000,
    "cash_price": 9412.5,
    "activity_date": "2026-04-17",
    "cancelled_qty": 11200000,
    "on_warrant_qty": 11200000,
    "off_warrant_qty": 11200000,
    "delivered_in_qty": 11200000,
    "delivered_out_qty": 11200000,
    "three_month_price": 9412.5,
    "location_breakdown": {
     "Brink's": 4210000,
     "JPMorgan": 6990000
    }
   }
  ],
  "source": "The Vault Report",
  "filters": {
   "metal": "gold"
  },
  "license": "CC BY 4.0",
  "related": [],
  "endpoint": "lme/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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lme-warehouse-stocks-api-b6faf87e/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)