# 2s.io CFTC Commitments of Traders (COT) API

> 2s.io CFTC Commitments of Traders (COT) API is a paid API for AI agents from 2s.io, paid per call via x402, $0.0045/call, status unknown (last checked 2026-09-14).

Returns weekly CFTC COT futures positioning data for a named market, including open interest, large speculator, commercial hedger, and small trader positions with week-over-week changes.

## Facts

- Endpoint: GET https://2s.io/api/econ/cot
- Price: $0.0045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-cftc-commitments-of-traders-cot-api-8fea4baa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iciIOtvxdMI50EktniWnh

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 2s-io-cftc-commitments-of-traders-cot-api-8fea4baa
```

Example prompt: Pull the last 4 weekly CFTC COT reports for CRUDE OIL futures — I want to see open interest, how large speculators and commercials are positioned, and how those positions have shifted week over week.

## When to prefer this

Use this endpoint when you need official CFTC futures positioning data (COT reports) for a specific commodity, index, or financial futures market. Ideal for sentiment analysis, contrarian trading signals, and tracking speculator vs. hedger positioning trends. Prefer over generic financial APIs when you specifically need structured COT data by market name without requiring an API key.

## Known failure modes

- Market name does not match any known CFTC market — returns empty or error response
- Ambiguous market name matches multiple markets — may return unexpected results
- CFTC data not yet published for the current week — most recent report may be up to 7 days old
- Limit parameter exceeds maximum of 50 — request rejected
- Payment failure or insufficient USDC balance — 402 response

## How this service works

CFTC Commitments of Traders (COT) — weekly futures positioning for a market (free/keyless). Match a market by name (e.g. 'E-MINI S&P', 'GOLD', 'CRUDE OIL', 'BITCOIN'). Each weekly report: open interest, large speculators (non-commercial) long/short/spread, commercials (hedgers) long/short, small (non-reportable) traders, and week-over-week changes. For positioning/sentiment analysis.

## Output

Returns one or more weekly COT report entries for the matched market, each containing: open interest, non-commercial (large speculator) long/short/spread positions, commercial (hedger) long/short positions, non-reportable (small trader) positions, and week-over-week changes for each category.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "market"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      },
      "market": {
       "type": "string",
       "maxLength": 60,
       "minLength": 2,
       "description": "Market name contains, e.g. GOLD, E-MINI S&P, CRUDE OIL."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-cftc-commitments-of-traders-cot-api-8fea4baa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)