Commitments of Traders (CFTC)

InfoTrie's Commitments of Traders dataset carries the positions the U.S. Commodity Futures Trading Commission publishes every week for each futures market, by trader category: the legacy, disaggregated and traders in financial futures (TFF) reports, futures-only and futures and options combined. Each weekly report is one edition. When the CFTC re-issues a report, the new figures are kept as a later vintage beside the old ones, each with the time it became public, so what was known on any day can be replayed.

Status: In rollout — available on request

Request a sampleView as Markdown

Key facts

ReportsLegacy, disaggregated, and traders in financial futures (TFF)
ScopeFutures only, and futures and options combined
Trader categoriesCommercial and non-commercial (legacy); producer/merchant, swap dealer, managed money (disaggregated); dealer, asset manager, leveraged funds (TFF); plus other reportable, total reportable and non-reportable
MeasuresOpen interest, long, short and spread positions, their weekly changes, shares of open interest and trader counts
FrequencyWeekly: one edition per report date (the Tuesday the positions reflect), usually released on the Friday
Point in timeRe-issued reports are kept as later vintages, each with its release time
DeliveryInfoTrie console datasets and the BI feed, with an API key on a plan that includes market data

Sources

  • U.S. Commodity Futures Trading Commission, Commitments of Traders report

Data dictionary

FieldTypeDescription
report_familytextThe report: legacy, disaggregated or tff (traders in financial futures).
report_scopetextfutures_only, or combined (futures and options combined).
contract_market_codetextThe CFTC contract market code (067651 WTI, 13874A E-mini S&P 500). Repeats per family, scope and trader category.
report_datedateThe day the positions reflect (a Tuesday as a rule), not the release
trader_categorytextThe trader category, one of the family's. legacy: noncommercial, commercial, total_reportable, nonreportable; disaggregated: producer_merchant, swap_dealer, managed_money, other_reportable, total_reportable, nonreportable; tff: dealer, asset_manager, leveraged_funds, other_reportable, total_reportable, nonreportable.
series_keytextreport_family:report_scope:contract_market_code:trader_category, one row of a report (contract_market_code alone repeats per family, scope and category)
vintage_hashtextA hash of the whole record as published (32 hex): a new hash for the same report, market and category is a re-issue, a new vintage.
released_attimestamp with time zoneWhen this vintage became public; released_at_precision says how it is known (observed, reissued, rule, bound, unknown; all but observed err late)
released_at_precisiontextHow far to trust released_at. observed: the publisher loaded it at the release; reissued: the time the changed values could have appeared at the latest; rule: the release schedule; bound: a day a delayed release had caught up by; unknown: an estimate for reports whose lag is not checked. All but observed err late.
superseded_attimestamp with time zoneWhen the next vintage of the same row was released; NULL while this one is the latest
retrieved_attimestamp with time zoneWhen the adapter read the record.
market_and_exchange_namestextDescriptive, as published. NULL when the source gives none.
contract_market_nametextDescriptive, as published. NULL when the source gives none.
market_codetextThe exchange (NYME, CBT, ...), as published. NULL when the source gives none.
commodity_nametextDescriptive, as published. NULL when the source gives none.
commodity_group_nametextDescriptive, as published. NULL when the source gives none.
commodity_subgroup_nametextDescriptive, as published. NULL when the source gives none.
contract_unitstextThe contract's units, as published. NULL when the source gives none.
open_interestnumericThe market's open interest (never negative), as published.
change_open_interestnumericThe market's change in open interest, as published.
traders_totalnumericThe market's total number of traders (never negative), as published.
positions_longnumericThe category's long positions (never negative), as published; NULL where the report has none.
positions_shortnumericThe category's short positions (never negative), as published; NULL where the report has none.
positions_spreadnumericThe category's spread positions (never negative), as published; NULL where the report has none (no spread for commercials).
change_longnumericThe category's change in long positions, as published; NULL where the report has none.
change_shortnumericThe category's change in short positions, as published; NULL where the report has none.
change_spreadnumericThe category's change in spread positions, as published; NULL where the report has none.
pct_oi_longnumericPercent of open interest, as published (also pct_oi_short, pct_oi_spread)
pct_oi_shortnumericThe category's short positions, percent of open interest, as published; NULL where the report has none.
pct_oi_spreadnumericThe category's spread positions, percent of open interest, as published; NULL where the report has none.
traders_longnumericThe category's number of traders long (never negative), as published; NULL where the report has none (no traders for non-reportables).
traders_shortnumericThe category's number of traders short (never negative), as published; NULL where the report has none (no traders for non-reportables).
traders_spreadnumericThe category's number of traders spreading (never negative), as published; NULL where the report has none.
sourcetextThe public label of the source the row was taken from. Every source of this dataset republishes the CFTC's reports, so attribution and source_statement carry the CFTC's conditions whatever the source.
attributiontextThe attribution the CFTC asks for
source_statementtextThe CFTC's statement on its COT reports, verbatim (cftc.gov, Commitments of Traders, section 8, read 2026-11-05)

Use cases

  • Positioning signals. Follow how managed money, dealers or asset managers are positioned in a futures market week by week.
  • Backtests without look-ahead. Use the vintages and release times to see the figures as they were known on each day.
  • Macro and commodity research. Compare positioning across commodities, currencies, rates and equity index futures.

Delivery

  • InfoTrie console: the dataset's quality status and its rows, one edition per report date, with an API key on a plan that includes market data
  • BI feed: OData v4 for Power BI, Excel and Tableau; JSON or CSV pages for Qlik, Google Sheets and Looker Studio

Frequently asked questions

Do you add net positions or a positioning index?

No. The figures are served as the CFTC publishes them; net positions and any index are left to the reader to compute.

How do I credit the source?

Every row carries the line "Source: U.S. Commodity Futures Trading Commission, Commitments of Traders report" and the CFTC's statement that it publishes the reports from data it gets from reporting entities and does not analyse the data or make recommendations on it. Show both with the data. The CFTC does not endorse InfoTrie or anything derived from its reports.

See also

Talk to us about Commitments of Traders (CFTC)