# Vextorium Futures Positioning (CFTC COT Data)

> Vextorium Futures Positioning (CFTC COT Data) is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-27).

Returns CFTC Commitments of Traders (COT) futures positioning data — long, short, and net positions for commercials, large speculators, and small traders — for a given market and history window.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/futures-positioning?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-futures-positioning-cftc-cot-data-d2f313ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B50jvJePG4X9barn-cIsv

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 vextorium-futures-positioning-cftc-cot-data-d2f313ec -d '<json body>'
```

Example prompt: Pull the CFTC Commitments of Traders positioning data for GOLD futures for the last 8 weeks — I want to see how commercials and large speculators are positioned.

## When to prefer this

Use this endpoint when you need weekly CFTC Commitments of Traders (COT) data for futures markets including commodities (gold, crude oil), equity indices (E-Mini S&P 500), currencies (Euro FX), or crypto (Bitcoin). It provides structured JSON with historical weekly snapshots broken down by trader category (commercials, large speculators, small traders), which is ideal for sentiment analysis, market positioning research, or macro trading signals. Prefer this over scraping CFTC's website directly or parsing raw COT report files.

## Known failure modes

- Market name not found — returns empty markets array if the search term doesn't match any CFTC market
- Weeks parameter out of range (must be 1–26) — may return error or clamp to valid range
- Stale data — CFTC COT data is weekly (released Fridays for Tuesday positions), so the latest report may be up to a week old
- Multiple markets returned — a broad search term like 'GOLD' may return both GOLD and MICRO GOLD contracts
- No data for very recent weeks — if the latest report hasn't been processed yet, history may be shorter than requested

## How this service works

244 pay-per-call data APIs for AI agents: official statistics and economy (ECB, Fed, Eurostat, World Bank, SEC, BOE, INE), crypto prices and sentiment, Spanish public data, compliance (sanctions, VAT, IBAN, LEI), science, weather, web and developer tools and local AI text tools. Pay in USDC via x402.

## Output

A JSON object containing one or more matching markets, each with a history array of weekly COT snapshots. Each snapshot includes the report date, total open interest, change in open interest, and long/short/net/spreading positions for commercials, large speculators, and small traders. Also includes the source attribution and the date of the latest available report.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "weeks": {
   "type": "integer",
   "description": "Weeks of history, 1-26 (default 4)"
  },
  "market": {
   "type": "string",
   "description": "Market name or part of it: GOLD, CRUDE OIL, E-MINI S&P 500, BITCOIN, EURO FX..."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "GOLD",
  "report": "Legacy, futures only, weekly (Tuesday positions)",
  "source": "Source: U.S. Commodity Futures Trading Commission, Commitments of Traders (public domain). Not endorsed by the CFTC.",
  "markets": [
   {
    "market": "GOLD - COMMODITY EXCHANGE INC.",
    "history": [
     {
      "commercials": {
       "net": -242531,
       "long": 54419,
       "short": 296950
      },
      "report_date": "2026-10-13",
      "open_interest": 396345,
      "small_traders": {
       "long": 50731,
       "short": 16079
      },
      "large_speculators": {
       "net": 207879,
       "long": 245300,
       "short": 37421,
       "spreading": 45895
      },
      "change_open_interest": 236
     },
     {
      "commercials": {
       "net": -244527,
       "long": 55802,
       "short": 300329
      },
      "report_date": "2026-10-06",
      "open_interest": 396109,
      "small_traders": {
       "long": 50464,
       "short": 16272
      },
      "large_speculators": {
       "net": 210335,
       "long": 245403,
       "short": 35068,
       "spreading": 44440
      },
      "change_open_interest": -10347
     }
    ],
    "contract_code": "088691"
   },
   {
    "market": "MICRO GOLD - COMMODITY EXCHANGE INC.",
    "history": [
     {
      "commercials": {
       "net": 8027,
       "long": 8027,
       "short": 0
      },
      "report_date": "2026-10-13",
      "open_interest": 110505,
      "small_traders": {
       "long": 44752,
       "short": 24721
      },
      "large_speculators": {
       "net": -28058,
       "long": 52364,
       "short": 80422,
       "spreading": 5362
      },
      "change_open_interest": 9209
     },
     {
      "commercials": {
       "net": 8131,
       "long": 8131,
       "short": 0
      },
      "report_date": "2026-10-06",
      "open_interest": 101296,
      "small_traders": {
       "long": 44091,
       "short": 25210
      },
      "large_speculators": {
       "net": -27012,
       "long": 46462,
       "short": 73474,
       "spreading": 2612
      },
      "change_open_interest": -194
     }
    ],
    "contract_code": "088695"
   }
  ],
  "latest_report_date": "2026-10-13"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-futures-positioning-cftc-cot-data-d2f313ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)