GET/api/v1/cot$0.02

Commitments of Traders snapshot: net futures positioning across major equity-index, metal, energy, FX, rates & crypto markets in one call

The weekly CFTC Commitments of Traders positioning across major futures markets in one call: for each market the open interest, non-commercial (large speculator) net position and weekly change, and commercial (hedger) net position. Covers equity indices, gold/silver, crude/natural gas, major FX, the 10-year note, and bitcoin. No ticker needed. Sourced from the US CFTC.

Example request

GET /api/v1/cot

Response type (TypeScript)

interface CotResponse {
  source: string;
  as_of: string;
  report: string;
  markets: Array<{
    market: string;
    contract_code: string;
    name: string;
    group: string;
    report_date: string;
    open_interest: number;
    open_interest_change: number;
    noncommercial_net: number;
    noncommercial_net_change: number;
    commercial_net: number;
  }>;
  attribution: string;
}

Example response (click to expand)

{
  "source": "cftc",
  "as_of": "2026-06-02T00:00:00.000Z",
  "report": "legacy_futures_only",
  "markets": [
    {
      "market": "sp500",
      "contract_code": "13874A",
      "name": "E-Mini S&P 500",
      "group": "equity_index",
      "report_date": "2026-06-02",
      "open_interest": 2149231,
      "open_interest_change": 55610,
      "noncommercial_net": -220768,
      "noncommercial_net_change": -54937,
      "commercial_net": 110074
    },
    {
      "market": "nasdaq",
      "contract_code": "209742",
      "name": "Nasdaq-100 Mini",
      "group": "equity_index",
      "report_date": "2026-06-02",
      "open_interest": 314972,
      "open_interest_change": 11982,
      "noncommercial_net": -14949,
      "noncommercial_net_change": -8864,
      "commercial_net": 13812
    },
    {
      "market": "gold",
      "contract_code": "088691",
      "name": "Gold",
      "group": "metals",
      "report_date": "2026-06-02",
      "open_interest": 326052,
      "open_interest_change": -27437,
      "noncommercial_net": 176020,
      "noncommercial_net_change": 21760,
      "commercial_net": -206345
    },
    {
      "market": "silver",
      "contract_code": "084691",
      "name": "Silver",
      "group": "metals",
      "report_date": "2026-06-02",
      "open_interest": 102809,
      "open_interest_change": 1065,
      "noncommercial_net": 23926,
      "noncommercial_net_change": 1703,
      "commercial_net": -42661
    },
    {
      "market": "crude-oil",
      "contract_code": "067651",
      "name": "WTI Crude Oil",
      "group": "energy",
      "report_date": "2026-06-02",
      "open_interest": 2025180,
      "open_interest_change": 21385,
      "noncommercial_net": 155874,
      "noncommercial_net_change": -5124,
      "commercial_net": -188109
    },
    {
      "market": "natural-gas",
      "contract_code": "023651",
      "name": "Natural Gas (Henry Hub)",
      "group": "energy",
      "report_date": "2026-06-02",
      "open_interest": 1664003,
      "open_interest_change": 23921,
      "noncommercial_net": -186115,
      "noncommercial_net_change": 17066,
      "commercial_net": 173913
    },
    {
      "market": "euro",
      "contract_code": "099741",
      "name": "Euro FX",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 842424,
      "open_interest_change": 18200,
      "noncommercial_net": 48866,
      "noncommercial_net_change": 19440,
      "commercial_net": -69396
    },
    {
      "market": "british-pound",
      "contract_code": "096742",
      "name": "British Pound",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 271147,
      "open_interest_change": -10918,
      "noncommercial_net": -52218,
      "noncommercial_net_change": 9180,
      "commercial_net": 61093
    },
    {
      "market": "japanese-yen",
      "contract_code": "097741",
      "name": "Japanese Yen",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 505555,
      "open_interest_change": 78261,
      "noncommercial_net": -129567,
      "noncommercial_net_change": -14900,
      "commercial_net": 127768
    },
    {
      "market": "swiss-franc",
      "contract_code": "092741",
      "name": "Swiss Franc",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 111432,
      "open_interest_change": 5838,
      "noncommercial_net": -32909,
      "noncommercial_net_change": 2231,
      "commercial_net": 44829
    },
    {
      "market": "us-dollar-index",
      "contract_code": "098662",
      "name": "U.S. Dollar Index",
      "group": "fx",
      "report_date": "2026-06-02",
      "open_interest": 43090,
      "open_interest_change": 812,
      "noncommercial_net": 3758,
      "noncommercial_net_change": 2908,
      "commercial_net": -5402
    },
    {
      "market": "10y-note",
      "contract_code": "043602",
      "name": "10-Year U.S. Treasury Note",
      "group": "rates",
      "report_date": "2026-06-02",
      "open_interest": 5323279,
      "open_interest_change": -931193,
      "noncommercial_net": -829575,
      "noncommercial_net_change": -41621,
      "commercial_net": 821742
    },
    {
      "market": "bitcoin",
      "contract_code": "133741",
      "name": "Bitcoin",
      "group": "crypto",
      "report_date": "2026-06-02",
      "open_interest": 19882,
      "open_interest_change": -1743,
      "noncommercial_net": 2458,
      "noncommercial_net_change": 176,
      "commercial_net": -2595
    }
  ],
  "attribution": "Source: U.S. Commodity Futures Trading Commission (CFTC) Commitments of Traders"
}

GET/api/v1/cot/{market}$0.01

Commitments of Traders for one futures market: long/short/net by trader group, with weekly changes and history

CFTC Commitments of Traders for one futures market by slug: sp500, nasdaq, gold, silver, crude-oil, natural-gas, euro, british-pound, japanese-yen, swiss-franc, us-dollar-index, 10y-note, bitcoin. Returns open interest and non-commercial, commercial, and non-reportable long/short/net with weekly changes plus net history. `?weeks=` 12 (max 52). From the US CFTC.

Example request

GET /api/v1/cot/gold

Response type (TypeScript)

interface CotMarketResponse {
  source: string;
  as_of: string;
  market: string;
  contract_code: string;
  name: string;
  group: string;
  latest: {
    report_date: string;
    open_interest: number;
    open_interest_change: number;
    noncommercial: {
      long: number;
      short: number;
      spreading: number;
      net: number;
      long_change: number;
      short_change: number;
    };
    commercial: {
      long: number;
      short: number;
      net: number;
      long_change: number;
      short_change: number;
    };
    nonreportable: {
      long: number;
      short: number;
      net: number;
    };
    total_traders: number;
  };
  history: Array<{
    report_date: string;
    open_interest: number;
    noncommercial_net: number;
    commercial_net: number;
  }>;
  report: string;
  attribution: string;
}

Example response (click to expand)

{
  "source": "cftc",
  "as_of": "2026-06-02T00:00:00.000Z",
  "market": "gold",
  "contract_code": "088691",
  "name": "Gold",
  "group": "metals",
  "latest": {
    "report_date": "2026-06-02",
    "open_interest": 326052,
    "open_interest_change": -27437,
    "noncommercial": {
      "long": 206096,
      "short": 30076,
      "spreading": 22449,
      "net": 176020,
      "long_change": 5392,
      "short_change": -16368
    },
    "commercial": {
      "long": 53851,
      "short": 260196,
      "net": -206345,
      "long_change": -20790,
      "short_change": -211
    },
    "nonreportable": {
      "long": 43656,
      "short": 13331,
      "net": 30325
    },
    "total_traders": 258
  },
  "history": [
    {
      "report_date": "2026-06-02",
      "open_interest": 326052,
      "noncommercial_net": 176020,
      "commercial_net": -206345
    },
    {
      "report_date": "2026-05-26",
      "open_interest": 353489,
      "noncommercial_net": 154260,
      "commercial_net": -185766
    },
    {
      "report_date": "2026-05-19",
      "open_interest": 379325,
      "noncommercial_net": 159833,
      "commercial_net": -191629
    },
    {
      "report_date": "2026-05-12",
      "open_interest": 376496,
      "noncommercial_net": 171622,
      "commercial_net": -210258
    },
    {
      "report_date": "2026-05-05",
      "open_interest": 367932,
      "noncommercial_net": 163303,
      "commercial_net": -198935
    },
    {
      "report_date": "2026-04-28",
      "open_interest": 369530,
      "noncommercial_net": 159571,
      "commercial_net": -194813
    },
    {
      "report_date": "2026-04-21",
      "open_interest": 365842,
      "noncommercial_net": 164006,
      "commercial_net": -202940
    },
    {
      "report_date": "2026-04-14",
      "open_interest": 362274,
      "noncommercial_net": 162526,
      "commercial_net": -201082
    },
    {
      "report_date": "2026-04-07",
      "open_interest": 354877,
      "noncommercial_net": 156305,
      "commercial_net": -193751
    },
    {
      "report_date": "2026-03-31",
      "open_interest": 361409,
      "noncommercial_net": 163202,
      "commercial_net": -201640
    },
    {
      "report_date": "2026-03-24",
      "open_interest": 403925,
      "noncommercial_net": 168327,
      "commercial_net": -203828
    },
    {
      "report_date": "2026-03-17",
      "open_interest": 411388,
      "noncommercial_net": 159869,
      "commercial_net": -198648
    }
  ],
  "report": "legacy_futures_only",
  "attribution": "Source: U.S. Commodity Futures Trading Commission (CFTC) Commitments of Traders"
}