# CFTC Commitments of Traders by Market

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

Returns CFTC Commitments of Traders (COT) report data for a specific futures market, including open interest and long/short/net positions for non-commercial, commercial, and non-reportable traders with weekly changes and historical net data.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/cot/{market}?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-cftc-commitments-of-traders-by-market-4e468e4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ai5FhZXBTn_m0-B7zwkiw

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 agents-x402stock-xyz-cftc-commitments-of-traders-by-market-4e468e4a
```

Example prompt: Pull the latest CFTC Commitments of Traders data for gold futures, including the last 12 weeks of net position history, so I can see how commercial and non-commercial traders are positioned.

## When to prefer this

Choose this endpoint when you need official US CFTC Commitments of Traders positioning data for supported futures markets (equity indices, metals, energy, FX, rates, crypto). It is ideal for analyzing market sentiment, tracking speculator vs. hedger positioning trends, and accessing historical net position series up to 52 weeks back. Prefer this over general market data endpoints when the specific question involves trader category breakdowns (commercial vs. non-commercial) from the official regulatory report.

## Known failure modes

- Invalid market slug returns an error — must use exact slugs like 'sp500', 'crude-oil', 'bitcoin'
- Weeks parameter exceeding 52 is rejected
- CFTC data may be delayed (released weekly, typically Fridays) so latest report may lag current date by days
- Payment failure if insufficient USDC balance for $0.01 per-call charge
- Null fields in response if CFTC has not yet published data for the current week

## How this service works

Commitments of Traders for one futures market

## Output

A JSON object containing the market name, contract code, asset group classification, the latest COT report date, open interest and its weekly change, and broken-down long/short/net positions plus weekly changes for non-commercial (large speculators), commercial (hedgers), and non-reportable (small traders) participants. Also includes a historical array of net positions for up to 52 weeks, a source attribution, and the as-of date of the data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "market"
 ],
 "properties": {
  "weeks": {
   "type": "integer",
   "default": 12,
   "maximum": 52,
   "exclusiveMinimum": 0
  },
  "market": {
   "type": "string",
   "description": "CFTC Commitments-of-Traders market/commodity name."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "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"
          },
          {
           "type": "null"
          }
         ]
        },
        "short": {
         "anyOf": [
          {
           "type": "number"
          },
          {
           "type": "null"
          }
         ]
        },
        "long_change": {
         "anyOf": [
          {
           "type": "number"
          },
          {
           "type": "null"
          }
         ]
        },
        "short_change": {
         "anyOf": [
          {
           "type": "number"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "additionalProperties": false
      },
      "report_date": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "noncommercial": {
       "type": "object",
       "required": [
        "long",
        "short",
        "spreading",
        "net",
        "long_change",
        "short_change"
       ],
       "properties": {
        "net": {
         "anyOf": [
          {
           "type": "number"
          },
          {
           "type": "null"
          }
         ]
        },
        "long": {
         "anyOf": [
          {
           "type": "number"
          },
          {
           "type": "null"
          }
         ]
   
… (truncated)
```

## More

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