# ByKaranteli CFTC COT Weekly History

> ByKaranteli CFTC COT Weekly History is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Returns full weekly CFTC Commitments of Traders history for crypto futures, including dealer, asset manager, leveraged fund, other reportable, and non-reportable long/short positions plus open interest.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/cot-history?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-cftc-cot-weekly-history-199df1e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MsXlKtdvgDXLTJR3Rhaip

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 bykaranteli-cftc-cot-weekly-history-199df1e7
```

Example prompt: Pull the CFTC COT weekly history for BTC from 2023-01-01 to 2024-01-01 and show me the leveraged fund long and short positions along with open interest — limit to 100 rows.

## When to prefer this

Choose this endpoint when you need historical weekly CFTC Commitments of Traders data specifically for crypto futures markets, with breakdown by trader category (dealer, asset manager, leveraged fund). Prefer it over general market data endpoints when regulatory position reporting, institutional sentiment analysis, or COT-based trading signals are the goal. It is particularly suited for backtesting COT-based strategies or building dashboards that track how different market participants have positioned over time.

## Known failure modes

- Invalid or unsupported symbol returns empty rows array
- Date range produces no matching reports (future dates or pre-data era)
- Limit parameter exceeds dataset cap, silently capped
- Missing required method or type fields in input schema returns validation error
- Payment failure (402) if USDC balance insufficient for the $0.005 per-call fee

## How this service works

CFTC Commitments of Traders weekly history for crypto futures with the columns the free CSV does not carry: dealer long and short books and week-over-week change in open interest, alongside every participant class. The free CC0 download covers hedge fund, institutional, other reportable and small trader positions.

## Output

A JSON object with an `ok` flag, a `dataset` label ('cot-history'), a `count` of rows returned, and a `rows` array where each row contains weekly CFTC position breakdowns by trader category (dealer, asset manager, leveraged fund, other reportable, non-reportable) with long and short values plus open interest, filtered by symbol, currency, exchange, and date window as specified.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "date, optional"
      },
      "from": {
       "type": "string",
       "description": "date, optional"
      },
      "limit": {
       "type": "number",
       "description": "number, optional, max 3000"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "rows": [],
  "count": 500,
  "dataset": "cot-history"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-cftc-cot-weekly-history-199df1e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bykaranteli.com](https://www.zero.xyz/host/bykaranteli.com/llms.txt)