Free COT Data API

Endpoints

Examples

curl https://xoomar.com/api/markets/cot/euro-fx

import requests

r = requests.get("https://xoomar.com/api/markets/cot/euro-fx")
for report in r.json()["data"][:5]:
    net = report["levFundLong"] - report["levFundShort"]
    print(f"{report['reportDate']}: lev funds net {net:+,}")

const res = await fetch("https://xoomar.com/api/markets/cot/euro-fx");
const { data } = await res.json();
console.table(data.slice(0, 5));

Honest Limits

• Data updates weekly (released Friday evening US time, we fetch within hours).
• Report covers positions as of Tuesday of that week (standard CFTC lag).
• We parse the Traders in Financial Futures (TFF) report. Disaggregated data available for some markets.
• Not all markets have complete history back to 2010; depends on when the CFTC started reporting them.

Main Features

• ✓Weekly CFTC Commitment of Traders positioning for 700+ futures markets: currencies, indices, crypto, metals, energy, bonds, and agriculture.
• ✓Traders in Financial Futures (TFF) breakdown: dealer, asset manager, leveraged funds, and other reportables, long and short for each.
• ✓History back to 2010 for major markets, parsed from official CFTC files within hours of the Friday release.
• ✓COT Index (current net position as a percentile of its 1-year range) precomputed on our market pages from this same data.
• ✓Byte-identical with the CFTC source: we verified our euro-fx row matches the official FinFutWk.txt field for field.

How It Works

The CFTC publishes every Friday at 3:30pm ET; we parse and serve it the same evening.

Real Example

Request

curl "https://xoomar.com/api/markets/cot/gold"

Response (captured live, trimmed)

{
  "data": [
    {
      "id": 204055,
      "marketId": "bc1534ae-2128-42ee-94a1-55c374c825ba",
      "reportDate": "2026-06-02",
      "openInterest": 326052,
      "dealerLong": 10275,
      "dealerShort": 30429,
      "assetMgrLong": 213696,
      "assetMgrShort": 16071,
      "levFundLong": 17188,
      "levFundShort": 12456,
      "otherLong": 12888,
      "otherShort": 9993,
      "nonreptLong": 312721,
      "nonreptShort": 43656,
      "raw": {
        "col_0": "GOLD - COMMODITY EXCHANGE INC.",
        "col_1": "260602",
        "col_2": "2026-06-02",
        "col_3": "088691",
        "col_4": "CMX",
        "col_5": "01",
        "col_6": "088",
        "col_7": "326052",
        "col_8": "10275",
        "col_9": "30429",
        "col_10": "27505",
        "col_11": "213696",
        "col_12": "16071",
        "col_13": "129367",
        "col_14": "17188",
        "col_15": "12456",
        "col_16": "76729",
        "col_17": "12888",
        "col_18": "9993",
        "col_19": "282396",
        "col_20": "312721",
        "col_21": "43656",
        "col_22": "13331",

Each row is one weekly report. Compute net positioning as levFundLong minus levFundShort; asset managers are the slower institutional money.

What People Build With This

Response Shape

Every endpoint returns the same JSON envelope: { data, updatedAt, source, docs }. The data field is an array of records with these fields:

The hub endpoint returns the latest report for every market. The per-market endpoint /api/markets/cot/{slug} returns full weekly history, newest first, back to 2010 for majors.

Numeric values arrive as strings where precision matters (prices, rates); parse with your language's decimal type for accounting-grade math. Rate limiting is fair-use per IP; a 429 response includes a Retry-After header. No authentication, no API key, no signup. Attribution is appreciated: xoomar.com/markets.