# CFTC Commitments of Traders (COT) Data by Market

> CFTC Commitments of Traders (COT) Data by Market is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns weekly CFTC Commitments of Traders positioning data for a specific futures market, including speculator/hedger/small-trader net positions, 1w/4w changes, COT index, and crowded long/short signals.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/cot/:market?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cftc-commitments-of-traders-cot-data-by-market-baad1057
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ij3NpfJGvN5F4v9Lz2rtN

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-cot-data-by-market-baad1057
```

Example prompt: What's the current CFTC futures positioning for gold — are speculators crowded long or short, and what's the COT index reading? Give me the last 8 weeks of history.

## When to prefer this

Use this endpoint when you need institutional-grade futures positioning data (CFTC COT reports) for a specific asset — gold, WTI, S&P 500, Nasdaq, Treasuries, EUR, JPY, Bitcoin, Ether, or other supported markets. It's ideal for pre-trade sentiment checks, identifying crowded trades, or monitoring speculator positioning trends. Prefer it over general price feeds when the question is about market structure and positioning rather than current price. The COT index (0-100) and CROWDED signal make it especially useful for contrarian or momentum overlay strategies.

## Known failure modes

- Unknown or unsupported market key returns an error — check /api/v1/cot for valid market list
- Weeks parameter outside 4–156 range returns a validation error
- CFTC data lag: COT reports are released weekly (Friday) with a Tuesday cutoff, so the latest week may be 3-5 days stale
- Payment failure (x402 protocol) if wallet has insufficient USDC balance
- Rate limiting if too many calls are made in quick succession

## How this service works

CFTC Commitments of Traders history for one market ($0.01): gold, WTI, S&P 500, Nasdaq, Treasuries, EUR, JPY, bitcoin, ether and more (aliases GOLD, SPY, BTC, EURUSD work) - speculators, hedgers and small traders net, 1w/4w change, COT index 0-100 and CROWDED_LONG/SHORT. Use for the futures positioning behind one market.

## Output

Returns a time series of weekly CFTC COT data for the requested market, including: net positions for speculators (large traders/managed money), commercial hedgers, and small traders; week-over-week and 4-week changes; a normalized COT index from 0 to 100 (0=historically max short, 100=historically max long); and a CROWDED_LONG or CROWDED_SHORT signal when positioning is at an extreme. Up to 156 weeks of history can be requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "market"
     ],
     "properties": {
      "market": {
       "type": "string",
       "examples": [
        "gold"
       ],
       "description": "One of 24 CFTC markets by key, alias or code: gold, silver, wti, natgas, sp500, nasdaq100, ust10y, eur, jpy, bitcoin, ether... (list: /api/v1/cot)."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "weeks": {
       "type": "integer",
       "default": 26,
       "maximum": 156,
       "minimum": 4,
       "description": "Weeks of history (4-156)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "description": "Example JSON response returned by this endpoint"
    }
   },
   "additionalProperties": true
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cftc-commitments-of-traders-cot-data-by-market-baad1057/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)