Commitment Of Traders Report

The Commitments of Traders (COT) is a market report by the Commodity Futures Trading Commission (CFTC), listing the holdings of participants in futures of financial instruments, metals, and other commodities. It is believed by some traders to give insight into the upcoming development of those markets. The CFTC releases a new report every Friday at 3:30 p.m. Eastern Time, and the report reflects the commitments of traders on the prior Tuesday.

The following functions return selected parts of the COT report, and work likewise in backtest and live trading:

COT (int Handle, string Code, int Field): var

Downloads the COT report with the given Quandl Code and stores it in the dataset with the given Handle. Returns the position determined by the Field number for the time of the current bar. If the dataset already exists, the data is not loaded again, but only the position returned.

COT_CommercialPos (int Handle, string Code): int

As before, but returns the net commercials position, i.e. the difference producer + swap dealer longs - producer + swap dealer shorts.

COT_CommercialIndex (int Handle, string Code, int TimePeriod): var

As before, but returns the commercials net position normalized over the given TimePeriod and scaled to 0..100.

COT_OpenInterest (int Handle, string Code): var

As before, but returns the open interest.


Positions, net positions, or index.


Handle Dataset handle for storing the report. Every report needs a dedicated handle.
Code The Quandl code number of the report; normally 6 digits or letters. Can be looked up under The "CTFC/" prefix and "_F_ALL" suffix of the Quandl database are automatically added.
Field The field of the report: 1 = open interest, 2 = producer long positions, 3 = producer short positions, 4 = swap dealer long positions, 5 = swap dealer short positions, 6 = noncommercials long positions, 7 = noncommercials short positions. 
TimePeriod The number of bars for normalizing the index.




#include <contract.c>

// Database symbols and codes below are just for illustration.
// Current available symbols can be found on the Quandl / NASDAQ website.
function run()
  StartDate = 2018;
  EndDate = 2023;
  BarPeriod = 1440;
  LookBack = 12*20;
  string COT_Code = "088691";
  var Ind = COT_CommercialIndex(1,COT_Code,6*20); // gold COT report
  plot("Fast Index",Ind,NEW,RED);
  var Ind2 = COT_CommercialIndex(1,COT_Code,12*20);
  plot("Slow Index",Ind2,0,BLUE);
  var Ind3 = COT_OpenInterest(1,COT_Code);
  plot("Open Interest",Ind3,NEW,BLACK);

See also:

asset, season, dataFromQuandl

► latest version online