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
| Reports | Legacy, disaggregated, and traders in financial futures (TFF) |
|---|---|
| Scope | Futures only, and futures and options combined |
| Trader categories | Commercial 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 |
| Measures | Open interest, long, short and spread positions, their weekly changes, shares of open interest and trader counts |
| Frequency | Weekly: one edition per report date (the Tuesday the positions reflect), usually released on the Friday |
| Point in time | Re-issued reports are kept as later vintages, each with its release time |
| Delivery | InfoTrie 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
| Field | Type | Description |
|---|---|---|
report_family | text | The report: legacy, disaggregated or tff (traders in financial futures). |
report_scope | text | futures_only, or combined (futures and options combined). |
contract_market_code | text | The CFTC contract market code (067651 WTI, 13874A E-mini S&P 500). Repeats per family, scope and trader category. |
report_date | date | The day the positions reflect (a Tuesday as a rule), not the release |
trader_category | text | The 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_key | text | report_family:report_scope:contract_market_code:trader_category, one row of a report (contract_market_code alone repeats per family, scope and category) |
vintage_hash | text | A 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_at | timestamp with time zone | When this vintage became public; released_at_precision says how it is known (observed, reissued, rule, bound, unknown; all but observed err late) |
released_at_precision | text | How 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_at | timestamp with time zone | When the next vintage of the same row was released; NULL while this one is the latest |
retrieved_at | timestamp with time zone | When the adapter read the record. |
market_and_exchange_names | text | Descriptive, as published. NULL when the source gives none. |
contract_market_name | text | Descriptive, as published. NULL when the source gives none. |
market_code | text | The exchange (NYME, CBT, ...), as published. NULL when the source gives none. |
commodity_name | text | Descriptive, as published. NULL when the source gives none. |
commodity_group_name | text | Descriptive, as published. NULL when the source gives none. |
commodity_subgroup_name | text | Descriptive, as published. NULL when the source gives none. |
contract_units | text | The contract's units, as published. NULL when the source gives none. |
open_interest | numeric | The market's open interest (never negative), as published. |
change_open_interest | numeric | The market's change in open interest, as published. |
traders_total | numeric | The market's total number of traders (never negative), as published. |
positions_long | numeric | The category's long positions (never negative), as published; NULL where the report has none. |
positions_short | numeric | The category's short positions (never negative), as published; NULL where the report has none. |
positions_spread | numeric | The category's spread positions (never negative), as published; NULL where the report has none (no spread for commercials). |
change_long | numeric | The category's change in long positions, as published; NULL where the report has none. |
change_short | numeric | The category's change in short positions, as published; NULL where the report has none. |
change_spread | numeric | The category's change in spread positions, as published; NULL where the report has none. |
pct_oi_long | numeric | Percent of open interest, as published (also pct_oi_short, pct_oi_spread) |
pct_oi_short | numeric | The category's short positions, percent of open interest, as published; NULL where the report has none. |
pct_oi_spread | numeric | The category's spread positions, percent of open interest, as published; NULL where the report has none. |
traders_long | numeric | The category's number of traders long (never negative), as published; NULL where the report has none (no traders for non-reportables). |
traders_short | numeric | The category's number of traders short (never negative), as published; NULL where the report has none (no traders for non-reportables). |
traders_spread | numeric | The category's number of traders spreading (never negative), as published; NULL where the report has none. |
source | text | The 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. |
attribution | text | The attribution the CFTC asks for |
source_statement | text | The 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.