# CFTC Commitments of Traders – Precious Metals Futures Positioning

> CFTC Commitments of Traders – Precious Metals Futures Positioning 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 weekly CFTC COT disaggregated futures positioning data (managed money, producer-merchant, swap dealer, open interest) for gold, silver, copper, and platinum with up to 20 years of history.

## Facts

- Endpoint: GET https://thevaultreport.com/api/x402/cot/positioning
- 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/cftc-commitments-of-traders-precious-metals-futures-positioning-ae123264
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AAjf1bklXgVxGiCs013lJ

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 cftc-commitments-of-traders-precious-metals-futures-positioning-ae123264
```

Example prompt: Pull me the CFTC COT disaggregated positioning data for gold from January 1, 2025 to April 30, 2025 — I want to see managed money long, short, and net positions along with open interest for each weekly report.

## When to prefer this

Use this endpoint when you need structured, cleaned, and canonicalized CFTC Commitments of Traders data for precious metals (gold, silver, copper, platinum) with up to 20 years of history. Prefer this over scraping the CFTC website directly when you need disaggregated positioning split by trader category (managed money, producer-merchant, swap dealer) and want consistent JSON output without parsing raw CFTC files.

## Known failure modes

- Invalid commodity enum value returns 400 or empty results
- Date range with no data returns empty rows array with total_matches=0
- Malformed date format (not ISO 8601) may cause 400 error
- Page number beyond last page returns empty rows
- Payment not processed results in 402 Payment Required
- Very large date ranges may require many paginated calls

## How this service works

CFTC Commitments of Traders — weekly disaggregated futures positioning by commodity: managed-money long/short/net, producer-merchant, swap-dealer, and open interest. 20-year history, cleaned and canonicalized from the CFTC feed. Filter by commodity (gold/silver/copper/platinum/palladium/wti_crude).

## Output

A paginated list of weekly COT report rows for the requested commodity and date range. Each row includes report_date, contract_code, managed_money_long, managed_money_short, managed_money_net, producer_merchant_long, producer_merchant_short, swap_long, swap_short, and open_interest. Response also includes total_matches, returned count, page, page_size, next_page (null if last page), source URL, attribution, and generated_at timestamp.

## 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
      },
      "commodity": {
       "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": {
         "commodity": {
          "type": "string"
         },
         "swap_long": {
          "type": "number"
         },
         "swap_short": {
          "type": "number"
         },
         "report_date": {
          "type": "string",
          "format": "date"
         },
         "contract_code": {
          "type": "string"
         },
         "open_interest": {
          "type": "number"
         },
         "managed_money_net": {
          "type": "number"
         },
         "managed_money_long": {
          "type": "number"
         },
         "managed_money_short": {
          "type": "number"
         },
         "producer_merchant_long": {
          "type": "number"
         },
         "producer_merchant_short": {
          "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 wor
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "rows": [
   {
    "commodity": "GOLD",
    "swap_long": 1250,
    "swap_short": 1250,
    "report_date": "2026-04-17",
    "contract_code": "088691",
    "open_interest": 418200,
    "managed_money_net": 1250,
    "managed_money_long": 1250,
    "managed_money_short": 1250,
    "producer_merchant_long": 1250,
    "producer_merchant_short": 1250
   }
  ],
  "source": "The Vault Report",
  "filters": {
   "metal": "gold"
  },
  "license": "CC BY 4.0",
  "related": [],
  "endpoint": "cot/positioning",
  "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/cftc-commitments-of-traders-precious-metals-futures-positioning-ae123264/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)