# CFTC — Zapi reference

> Commitments of Traders: posisi long/short per kategori pelaku di tiap pasar berjangka Amerika, terbit tiap Jumat untuk posisi hari Selasa.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/cftc
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## CFTC

**Category:** finance · **Slug:** `cftc`
**Detail page:** https://zpi.web.id/api/finance/cftc

Commitments of Traders: posisi long/short per kategori pelaku di tiap pasar berjangka Amerika, terbit tiap Jumat untuk posisi hari Selasa.

**Tags:** cftc, cot, futures, positioning, finance

### Commitments of Traders

Baris COT terbaru, bisa disaring per nama kontrak dan tanggal laporan. Net non-commercial dan commercial dihitung di sini.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:cftc/commitments`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `market` | string | query | no | Match against the contract name (case-insensitive substring). |
| `from` | string | query | no | Earliest report date (YYYY-MM-DD). |
| `length` | number | query | no | Rows to return (default 50, max 500) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:cftc/commitments?market=WHEAT&from=2026-01-01&length=50" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:cftc/commitments?market=WHEAT&from=2026-01-01&length=50", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:cftc/commitments?market=WHEAT&from=2026-01-01&length=50",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 8,
  "items": [
    {
      "date": "2026-08-04",
      "market": "MICRO GOLD",
      "exchange": "MICRO GOLD - COMMODITY EXCHANGE INC.",
      "commodity": "GOLD",
      "openInterest": 55508,
      "commercialNet": 7052,
      "commercialLong": 7052,
      "commercialShort": 0,
      "nonCommercialNet": -14594,
      "nonCommercialLong": 11511,
      "nonReportableLong": 31096,
      "nonCommercialShort": 26105,
      "nonReportableShort": 23554,
      "nonCommercialSpread": 5849
    },
    {
      "date": "2026-08-04",
      "market": "GOLD",
      "exchange": "GOLD - COMMODITY EXCHANGE INC.",
      "commodity": "GOLD",
      "openInterest": 371551,
      "commercialNet": -226491,
      "commercialLong": 71832,
      "commercialShort": 298323,
      "nonCommercialNet": 197634,
      "nonCommercialLong": 227013,
      "nonReportableLong": 44531,
      "nonCommercialShort": 29379,
      "nonReportableShort": 15674,
      "nonCommercialSpread": 28175
    },
    {
      "date": "2026-07-28",
      "market": "GOLD",
      "exchange": "GOLD - COMMODITY EXCHANGE INC.",
      "commodity": "GOLD",
      "openInterest": 384603,
      "commercialNet": -212309,
      "commercialLong": 75460,
      "commercialShort": 287769,
      "nonCommercialNet": 182070,
      "nonCommercialLong": 219622,
      "nonReportableLong": 61384,
      "nonCommercialShort": 37552,
      "nonReportableShort": 31145,
      "nonCommercialSpread": 28137
    },
    {
      "date": "2026-07-28",
      "market": "MICRO GOLD",
      "exchange": "MICRO GOLD - COMMODITY EXCHANGE INC.",
      "commodity": "GOLD",
      "openInterest": 83553,
      "commercialNet": 7037,
      "commercialLong": 7037,
      "commercialShort": 0,
      "nonCommercialNet": -10556,
      "nonCommercialLong": 35779,
      "nonReportableLong": 33926,
      "nonCommercialShort": 46335,
      "nonReportableShort": 30407,
      "nonCommercialSpread": 6811
    },
    {
      "date": "2026-07-28",
      "market": "PAX GOLD PERP STYLE",
      "exchange": "PAX GOLD PERP STYLE - COINBASE DERIVATIVES, LLC",
      "commodity": "OTHER CRYPTO/DIGITAL ASSET (NON-MAJOR)",
      "openInterest": 1324,
      "commercialNet": 0,
      "commercialLong": 0,
      "commercialShort": 0,
      "nonCommercialNet": -399,
      "nonCommercialLong": 739,
      "nonReportableLong": 585,
      "nonCommercialShort": 1138,
      "nonReportableShort": 186,
      "nonCommercialSpread": 0
    },
    {
      "date": "2026-07-21",
      "market": "GOLD",
      "exchange": "GOLD - COMMODITY EXCHANGE INC.",
      "commodity": "GOLD",
      "openInterest": 383368,
      "commercialNet": -213199,
      "commercialLong": 80457,
      "commercialShort": 293656,
      "nonCommercialNet": 183910,
      "nonCommercialLong": 224785,
      "nonReportableLong": 46143,
      "nonCommercialShort": 40875,
      "nonReportableShort": 16854,
      "nonCommercialSpread": 31983
    },
    {
      "date": "2026-07-21",
      "market": "MICRO GOLD",
      "exchange": "MICRO GOLD - COMMODITY EXCHANGE INC.",
      "commodity": "GOLD",
      "openInterest": 77769,
      "commercialNet": 7131,
      "commercialLong": 7131,
      "commercialShort": 0,
      "nonCommercialNet": -13814,
      "nonCommercialLong": 32489,
      "nonReportableLong": 35034,
      "nonCommercialShort": 46303,
      "nonReportableShort": 28351,
      "nonCommercialSpread": 3115
    },
    {
      "date": "2026-07-21",
      "market": "PAX GOLD PERP STYLE",
      "exchange": "PAX GOLD PERP STYLE - COINBASE DERIVATIVES, LLC",
      "commodity": "OTHER CRYPTO/DIGITAL ASSET (NON-MAJOR)",
      "openInterest": 1602,
      "commercialNet": 0,
      "commercialLong": 0,
      "commercialShort": 0,
      "nonCommercialNet": -509,
      "nonCommercialLong": 955,
      "nonReportableLong": 647,
      "nonCommercialShort": 1464,
      "nonReportableShort": 138,
      "nonCommercialSpread": 0
    }
  ],
  "market": "GOLD",
  "source": "cftc"
}
```

---


_Generated: 2026-08-08T12:12:33.427Z_