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

CFTC Commitments of Traders

US Commodity Futures Trading Commission Commitments of Traders (COT) reports from the public reporting SODA API (publicreporting.cftc.gov): the seven weekly datasets (Legacy, Disaggregated and Traders in Financial Futures, each futures-only and combined, plus the Supplemental commodity index report) with filters, column projection, deterministic recent-first order and offset pagination, and a contract-market discovery function.

10 ready-made skills use CFTC Commitments of Traders
Try in Agent
Get the first 12 CFTC Legacy futures-only gold reports from July through September 2026, with open interest and commercial and non-commercial positions.

Try CFTC Commitments of Traders now.

Choose an example or ask your own question.

CFTC Commitments of Traders
TRY ASKING
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
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
cftc_contract_market_codecftc_market_codeidmarket_and_exchange_namesopen_interest_allreport_date_as_yyyy_mm_dd
088691CMX 260915088691CGOLD - COMMODITY EXCHANGE INC.577454
088691CMX 260908088691CGOLD - COMMODITY EXCHANGE INC.582664

Use cases

10

Built-in skills that call CFTC Commitments of Traders.

Uses CFTC Commitments of Traders, NASA POWER, XE currency data, MSC shipment tracking and schedulesCocoa or coffee origin sourcing riskUse when a chocolate, coffee or food buyer is planning purchases from one origin country and wants the next quarter's risk in one view. Combines fund positioning in the futures market, rainfall against normal in the growing region, the origin currency, and shipping options from the origin port, returning a sourcing risk brief with timing suggestions.9 capabilitiesUse
Uses CFTC Commitments of Traders, CME Group FedWatch and market data, Forex Factory economic calendarCrowded commodity positioning checkUse before a commodity trader or hedge fund analyst adds to a futures position and wants to know whether speculators are already crowded on the same side. Reads managed money positioning from the CFTC disaggregated report, the price curve and volume at CME, and the next scheduled data releases, producing a crowding score and squeeze risk note.6 capabilitiesUse
Uses CME Group FedWatch and market data, CFTC Commitments of Traders, ACIS (NOAA Regional Climate Centers), US Energy Information AdministrationCountry elevator bid sheet checkUse when a grain merchandiser at a country elevator is setting the daily cash bid and basis for corn or soybeans. Reads nearby and new-crop futures settlements and volume, fund positioning, rainfall in the draw area that affects harvest pace, and diesel prices that drive trucking cost, then explains where basis should sit.7 capabilitiesUse
Uses CME Group FedWatch and market data, CFTC Commitments of Traders, NASA POWERFeedlot placement margin checkUse when a feedlot cattle buyer is deciding whether to place feeder cattle now. Reads feeder and live cattle futures for the placement and finish months, corn futures for feed cost, fund positioning in cattle, and pasture conditions in cow-calf regions that drive feeder supply, then lays out the margin inputs.6 capabilitiesUse
Uses CME Group FedWatch and market data, CFTC Commitments of Traders, NASA POWER, fredGrain sale timing checkUse when a grain farmer or elevator merchandiser is deciding whether to sell, store or hedge corn, soybeans or wheat this month. Reads the futures curve, how speculative funds are positioned, how the growing season looks across the main producing region, and the dollar, then lays out the case for selling now versus storing.7 capabilitiesUse
Uses US Energy Information Administration, CME Group FedWatch and market data, CFTC Commitments of TradersDiesel procurement hedge checkUse when a fuel procurement manager for a trucking or delivery fleet is deciding whether to lock in diesel prices. Reads retail diesel by region, distillate inventories, the ULSD futures curve and fund positioning, then sets out whether the market looks tight and what locking in now would mean against the curve.7 capabilitiesUse
Uses NOAA National Hurricane Center (nhc.noaa.gov), US Energy Information Administration, CFTC Commitments of TradersHurricane Gulf Coast fuel supply riskUse when an active Atlantic storm threatens the US Gulf Coast and a fuel trader, distributor or fleet manager needs to know what it could do to gasoline and diesel supply. Maps the forecast track, then reads Gulf Coast refinery runs, inventories and spot prices plus fund positioning, and returns a supply-risk brief with the exposed numbers.6 capabilitiesUse
Uses US Energy Information Administration, CME Group FedWatch and market data, CFTC Commitments of TradersWeekly crude balance and positioningUse when a crude oil trader or oil analyst is reading the weekly EIA petroleum status numbers and wants them in one view with prices and positioning. Reads commercial and Cushing crude stocks against last year, WTI and Brent spot, the futures curve shape and managed money positions, then says whether the data and positioning agree.7 capabilitiesUse
Uses US Energy Information Administration, ACIS (NOAA Regional Climate Centers), NASA POWER, CFTC Commitments of TradersPower price spike explainerUse after a US wholesale power price or demand spike when an energy trader, utility analyst or large buyer asks what caused it. Lines up hourly grid demand and fuel mix for the balancing authority with observed weather, the gas price that day and fund positioning in gas futures, and returns a ranked set of drivers with the numbers behind each.6 capabilitiesUse

Related providers

Browse the library
//
Get started
//
Give your agent CFTC Commitments of Traders.
One API key for the live web and every provider in Alexandria.
Use CFTC Commitments of TradersExplore Alexandria
Are you an AI agent? See setup options