# CFTC Commitments of Traders (COT) Positioning API

> CFTC Commitments of Traders (COT) Positioning API is a paid API for AI agents from macro-data-api-313m.onrender.com, paid per call via x402, $0.02/call, status down (last checked 2026-10-30).

Returns CFTC Commitments of Traders positioning data (non-commercial, commercial, and small trader long/short/net positions) for a specified futures market, with week-over-week changes and optional historical weeks.

## Facts

- Endpoint: GET https://macro-data-api-313m.onrender.com/v1/cot?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cftc-commitments-of-traders-cot-positioning-api-04466d3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SCRVOCqyO0Nl01Vefo3oM

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-positioning-api-04466d3d
```

Example prompt: What does the latest CFTC COT report say about speculator positioning in gold futures (GC) — give me the non-commercial long, short, and net positions along with the week-over-week change?

## When to prefer this

Use this endpoint when you need CFTC Commitments of Traders positioning data for major futures markets (equity indices, metals, energy, currencies, fixed income, or crypto) and want structured long/short/net breakdowns by trader category with week-over-week changes. Prefer this over scraping CFTC directly when you need clean, structured JSON output and optional historical time series. Best suited for macro analysis, sentiment tracking, and systematic trading research.

## Known failure modes

- Invalid or unsupported market symbol returns an error — only specific tickers like ES, NQ, GC, CL, 6E are accepted
- Weeks parameter out of range (less than 1 or greater than 260) may return an error or be clamped
- CFTC data may lag by one week as reports are released weekly on Fridays
- Service unavailability on Render hosting may cause timeouts or 503 errors
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Returns CFTC Commitments of Traders positioning (non-commercial, commercial and small traders: long, short, net) for a futures market, with week-over-week change and optional history.

## Output

Returns CFTC COT report data for the requested futures market including non-commercial (large speculator), commercial (hedger), and small trader long, short, and net position counts, week-over-week changes for each category, and optionally multiple weeks of historical data going back up to 260 weeks.

## 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",
     "required": [
      "market"
     ],
     "properties": {
      "weeks": {
       "type": "string",
       "description": "Weeks of history, 1-260. Default 1."
      },
      "market": {
       "type": "string",
       "description": "Market: ES, NQ, YM, RTY, GC, SI, CL, NG, 6E, 6J, 6B, 6S, ZN, BTC"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cftc-commitments-of-traders-cot-positioning-api-04466d3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from macro-data-api-313m.onrender.com](https://www.zero.xyz/host/macro-data-api-313m.onrender.com/llms.txt)