# x402stock CFTC Commitments of Traders (COT) Report

> x402stock CFTC Commitments of Traders (COT) Report is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-08).

Returns CFTC Commitments of Traders (COT) data for a specified futures market, including net positions for commercial, non-commercial, and non-reportable traders, with historical weekly data.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/cot/%7Bmarket%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-cftc-commitments-of-traders-cot-report-dc28f8af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oHmXZyPK4hksIuLV_GcE8

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 x402stock-cftc-commitments-of-traders-cot-report-dc28f8af
```

Example prompt: Pull the latest CFTC Commitments of Traders report for gold, showing the last 12 weeks of commercial and non-commercial net positioning history.

## When to prefer this

Use this endpoint when you need structured CFTC COT positioning data for futures markets including equity indices, metals, energy, forex, rates, and crypto. Ideal for sentiment analysis, contrarian trading signals, or monitoring institutional vs speculative positioning trends. Prefer over raw CFTC downloads when you need clean, parsed, ready-to-use JSON with historical series in a single call.

## Known failure modes

- Invalid or unsupported market name in path returns 404 or error
- weeks parameter out of range (must be 1-52) returns validation error
- Payment not fulfilled via x402/USDC results in 402 Payment Required
- Market data temporarily unavailable returns 503 or empty response
- CFTC report not yet published for current week returns stale or null as_of date

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns the latest COT report for the requested market including: open interest and change, commercial (long/short/net/changes), non-commercial (long/short/spreading/net/changes), non-reportable positions, total trader count, report date, contract code, market group classification, and a historical weekly series of net positions for the requested number of weeks. Also includes source attribution to the CFTC.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "weeks"
     ],
     "properties": {
      "weeks": {
       "type": "integer",
       "default": 12,
       "maximum": 52,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "market",
      "contract_code",
      "name",
      "group",
      "latest",
      "history",
      "report",
      "attribution"
     ],
     "properties": {
      "name": {
       "type": "string"
      },
      "as_of": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "group": {
       "enum": [
        "equity_index",
        "metals",
        "energy",
        "fx",
        "rates",
        "crypto"
       ],
       "type": "string"
      },
      "latest": {
       "anyOf": [
        {
         "type": "object",
         "required": [
          "report_date",
          "open_interest",
          "open_interest_change",
          "noncommercial",
          "commercial",
          "nonreportable",
          "total_traders"
         ],
         "properties": {
          "commercial": {
           "type": "object",
           "required": [
            "long",
            "short",
            "net",
            "long_change",
            "short_change"
           ],
           "properties": {
            "net": {
             "anyOf": [
              {
               "type": "number"
              },
              {
               "type": "null"
              }
             ]
            },
            "long": {
             "anyOf": [
              {
               "type": "number"
              },
          
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Gold",
  "as_of": "2026-06-02T00:00:00.000Z",
  "group": "metals",
  "latest": {
   "commercial": {
    "net": -206345,
    "long": 53851,
    "short": 260196,
    "long_change": -20790,
    "short_change": -211
   },
   "report_date": "2026-06-02",
   "noncommercial": {
    "net": 176020,
    "long": 206096,
    "short": 30076,
    "spreading": 22449,
    "long_change": 5392,
    "short_change": -16368
   },
   "nonreportable": {
    "net": 30325,
    "long": 43656,
    "short": 13331
   },
   "open_interest": 326052,
   "total_traders": 258,
   "open_interest_change": -27437
  },
  "market": "gold",
  "report": "legacy_futures_only",
  "source": "cftc",
  "history": [
   {
    "report_date": "2026-06-02",
    "open_interest": 326052,
    "commercial_net": -206345,
    "noncommercial_net": 176020
   }
  ],
  "attribution": "Source: U.S. Commodity Futures Trading Commission (CFTC) Commitments of Traders",
  "contract_code": "088691"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-cftc-commitments-of-traders-cot-report-dc28f8af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)