All providers
Sign in
Sign up to use CFTC Commitments of Traders
Firecrawl Alexandria
Public records

CFTC Commitments of Traders

1Request
string

Exact commodity_group_name, case-insensitive: AGRICULTURE, NATURAL RESOURCES, FINANCIAL INSTRUMENTS.

string

Exact commodity_name, case-insensitive (GOLD, WHEAT, NATURAL GAS, BITCOIN).

string

Exact commodity_subgroup_name, case-insensitive (GRAINS, PRECIOUS METALS, PETROLEUM AND PRODUCTS, CURRENCIES, STOCK INDICES, ...).

string

Exact cftc_contract_market_code, a string with leading zeros kept (088691 = GOLD - COMMODITY EXCHANGE INC., 001602 = WHEAT-SRW - CBOT). Discover codes with `markets`. Alone, a code with no rows in this dataset is not_found; combined with date or other filters an empty page is a legitimate empty result.

string[]

Projection: SODA column names to return (open_interest_all, noncomm_positions_long_all, m_money_positions_long_all, ...). The identity columns id, market_and_exchange_names, report_date_as_yyyy_mm_dd and cftc_contract_market_code are always included. An unknown column is invalid_input. Omit for every column. Separate values with commas.

number

Rows per page (a legacy row is ~4.7 KB, a disaggregated row ~7 KB).

5 credits
Codefollows the fields above
const result = await firecrawl.scrape({
  alexandria: {
    provider: "cftc-gov",
    capability: "commitments-of-traders/disaggregated_combined",
    options: {
      contract_market_code: "088691",
      fields: [
        "open_interest_all",
        "cftc_market_code",
      ],
      page_size: 2,
    },
  },
});
2Response example

This is a sample shape. Press Run to see live data from CFTC Commitments of Traders.

{
  "count": 2,
  "data_last_modified": "Fri, 18 Sep 2026 19:30:07 GMT",
  "dataset_id": "kh3c-gbw2",
  "futures_only": false,
  "next_cursor": "2",
  "observed_at_ms": 1790037939288,
  "report": "disaggregated_combined",
  "report_name": "Disaggregated - Combined",
  "rows": [
    {
      "cftc_contract_market_code": "088691",
      "cftc_market_code": "CMX ",
      "id": "260915088691C",
      "market_and_exchange_names": "GOLD - COMMODITY EXCHANGE INC.",
      "open_interest_all": "577454",
      "report_date_as_yyyy_mm_dd": "2026-09-15T00:00:00.000"
    },
    {
      "cftc_contract_market_code": "088691",
      "cftc_market_code": "CMX ",
      "id": "260908088691C",
      "market_and_exchange_names": "GOLD - COMMODITY EXCHANGE INC.",
      "open_interest_all": "582664",
      "report_date_as_yyyy_mm_dd": "2026-09-08T00:00:00.000"
    }
  ],
  "sort": "recent_first",
  "source_url": "https://publicreporting.cftc.gov/resource/kh3c-gbw2.json?$select=id,market_and_exchange_names,report_date_as_yyyy_mm_dd,cftc_contract_market_code,open_interest_all,cftc_market_code&$where=cftc_contract_market_code%3D%27088691%27&$order=report_date_as_yyyy_mm_dd%20DESC,id%20ASC&$limit=3&$offset=0"
}

Related providers

Browse the library