CFTC Commitments of Traders (COT) Data — Weekly Positions

Official source. No API key. Pay per record.

This actor reads the Commitments of Traders (COT) reports straight from the U.S. Commodity Futures Trading Commission's Public Reporting Environment and returns one clean record per market per weekly report: open interest; long, short and spread positions by trader category; the weekly change in each; percentages of open interest; trader counts; concentration ratios of the largest 4 and 8 traders; and computed net positions and weekly net changes per category.

All six COT report series are available:

Report	Trader categories	Rows on 2 Oct 2026
Legacy — futures only	commercial, non-commercial, non-reportable	290,030 (since 1986)
Legacy — futures and options combined	same	279,195 (since 1995)
Disaggregated — futures only / combined	producer-merchant, swap dealer, managed money, other reportable	185,631 / 191,743 (since 2006)
Traders in Financial Futures (TFF) — futures only / combined	dealer, asset manager, leveraged funds, other reportable	46,838 / 46,890 (since 2006)

The latest report in the source on 2 October 2026 is dated 29 September 2026 (377 Legacy futures markets). CFTC publishes each report on Friday for positions as of the Tuesday.

Use it three ways:

• Weekly positioning snapshot. latestReportOnly: true returns the newest report for every market you filter on.
• Positioning history. Every week for gold, crude oil, the S&P 500 or the euro since the series began, for charting net speculative positioning and its weekly velocity.
• Screening. All markets in a commodity group (agriculture, natural resources, financial instruments) for a date range.

Who buys this and for what job

• Traders and hedge funds following speculative and commercial positioning (net non-commercial, managed money, leveraged funds).
• Quant and research teams building positioning factors and back-tests from full weekly history.
• Commodity producers, merchants and risk managers watching who holds the market in their contracts.
• Financial media and newsletters publishing the weekly COT chart.
• Data and fintech teams feeding COT into dashboards without parsing CFTC files.

Sample output

From live run rqbMN7gT8oaaK3IJo (2 October 2026; Legacy futures-only, gold). The record below is shortened to its main fields; each record holds all 76 fields.

{
  "record_id": "CFTC:legacy_futures_only:260929088691F",
  "report_type": "legacy_futures_only",
  "report_name": "Legacy - Futures Only",
  "report_date": "2026-09-29",
  "market_and_exchange_names": "GOLD - COMMODITY EXCHANGE INC.",
  "report_date_as_yyyy_mm_dd": "2026-09-29T00:00:00.000",
  "yyyy_report_week_ww": "2026 Report Week 39",
  "contract_market_name": "GOLD",
  "cftc_contract_market_code": "088691",
  "cftc_market_code": "CMX",
  "cftc_region_code": "NYC",
  "cftc_commodity_code": "088",
  "commodity_name": "GOLD",
  "contract_units": "(CONTRACTS OF 100 TROY OUNCES)",
  "open_interest_all": 406456,
  "noncomm_positions_long_all": 249736,
  "noncomm_positions_short_all": 31104,
  "noncomm_postions_spread_all": 49105,
  "comm_positions_long_all": 58831,
  "comm_positions_short_all": 309798,
  "change_in_open_interest_all": -6344,
  "change_in_noncomm_long_all": -4246,
  "change_in_noncomm_short_all": 2975,
  "pct_of_oi_noncomm_long_all": 61.4,
  "traders_tot_all": 286,
  "conc_net_le_4_tdr_long_all": 20.6,
  "net_noncommercial": 218632,
  "change_in_net_noncommercial": -7221,
  "net_commercial": -250967,
  "change_in_net_commercial": 11936,
  "source": "U.S. Commodity Futures Trading Commission (CFTC) — Commitments of Traders, Public Reporting Environment",
  "source_dataset": "Legacy - Futures Only (Socrata dataset 6dca-aqww, https://publicreporting.cftc.gov/resource/6dca-aqww.json)",
  "licence": "Public domain — a work of the U.S. federal government, not subject to copyright in the United States (17 U.S.C. § 105).",
  "attribution": "Source: U.S. Commodity Futures Trading Commission, Commitments of Traders reports; reformatted by NexGen Signal.",
  "observed_at": "2026-10-03T05:34:07Z"
}

Input

{
  "reportType": "legacy_futures_only",
  "marketContains": ["GOLD - COMMODITY EXCHANGE"],
  "maxRecords": 10
}

Field	Meaning
reportType	legacy_futures_only (default), legacy_combined, disaggregated_futures_only, disaggregated_combined, tff_futures_only, tff_combined
marketContains	Texts matched against CFTC's "market and exchange names", e.g. CRUDE OIL, LIGHT SWEET, E-MINI S&P 500, EURO FX, CORN
contractCodes	Exact CFTC contract market codes, e.g. 088691 (gold), 067651 (WTI crude), 13874A (E-mini S&P 500)
commodityGroups	AGRICULTURE, NATURAL RESOURCES, FINANCIAL INSTRUMENTS
latestReportOnly	Only the newest report date for your filters
dateFrom, dateTo	Report-date range
sortBy	newest (default) or oldest
maxRecords	Most records delivered and billed in this run

What is in each record

Field names are CFTC's own, so they match the CFTC documentation (including CFTC's own spellings such as noncomm_postions_spread_all). Records hold the all-crop-years figures; the old/other crop-year splits of agricultural contracts are not included. Each record also carries:

• report_date (YYYY-MM-DD) and report_type;
• net_<category> = long minus short, and change_in_net_<category> = the week's change in that net position, for each trader category of the report;
• source, source_dataset, licence, attribution, observed_at.

COT data is published only in aggregate, market by market. There is no person-level information in it, and the actor requests a fixed list of columns.

Pricing

Apify plan	Price per record
Free	$0.05
Bronze	$0.045
Silver	$0.04
Gold, Platinum, Diamond	$0.0335

One record = one market on one report date. Records are delivered first and charged after; with a maximum total charge set, the actor stops before delivering records it could not charge for.

Run end states and receipt

• Delivered N CFTC Commitments of Traders record(s) — with a note when your maxRecords limit was reached.
• Nothing matched your filters — nothing charged.
• CAPPED — stopped at your maximum total charge.
• PARTIAL — the API stopped answering part-way; what was delivered is kept and charged.
• SOURCE UNAVAILABLE — the CFTC API could not be reached after retries; nothing charged.

The RUN_RECEIPT record lists the robots.txt decision for publicreporting.cftc.gov, the dataset used, the rows matching your filters, the latest report date, calls and retries, and delivered and charged counts. The actor waits at least one second between requests, as the site's robots.txt asks.

Source and licence

Data: U.S. Commodity Futures Trading Commission, Commitments of Traders reports, Public Reporting Environment (publicreporting.cftc.gov). Works of the U.S. federal government are in the public domain in the United States (17 U.S.C. § 105). This actor is not affiliated with or endorsed by the CFTC.

Part of NexGen Signal — official-source data products.