Commodity Futures Trading Commission · Schema

CFTC Commitments of Traders Row

Common base schema for a row of CFTC Commitments of Traders data returned by the SODA endpoints at publicreporting.cftc.gov. Specific report formats add additional category breakdowns.

CFTCCommitments of TradersFederal GovernmentFinancialFuturesOpen DataSODATrading

Properties

Name	Type	Description
market_and_exchange_names	string	Combined market and exchange name as published by the CFTC.
report_date_as_yyyy_mm_dd	string	Report Tuesday for the COT week.
cftc_contract_market_code	string	CFTC contract market code identifying the underlying contract.
cftc_market_code	string	CFTC market code.
cftc_region_code	string	CFTC region code.
cftc_commodity_code	string	CFTC commodity code (DCOT).
open_interest_all	string	Total reportable plus non-reportable open interest in the contract.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://publicreporting.cftc.gov/schemas/cot-row.json",
  "title": "CFTC Commitments of Traders Row",
  "description": "Common base schema for a row of CFTC Commitments of Traders data returned by the SODA endpoints at publicreporting.cftc.gov. Specific report formats add additional category breakdowns.",
  "type": "object",
  "properties": {
    "market_and_exchange_names": {
      "type": "string",
      "description": "Combined market and exchange name as published by the CFTC."
    },
    "report_date_as_yyyy_mm_dd": {
      "type": "string",
      "format": "date",
      "description": "Report Tuesday for the COT week."
    },
    "cftc_contract_market_code": {
      "type": "string",
      "description": "CFTC contract market code identifying the underlying contract."
    },
    "cftc_market_code": {
      "type": "string",
      "description": "CFTC market code."
    },
    "cftc_region_code": {
      "type": "string",
      "description": "CFTC region code."
    },
    "cftc_commodity_code": {
      "type": "string",
      "description": "CFTC commodity code (DCOT)."
    },
    "open_interest_all": {
      "type": "string",
      "description": "Total reportable plus non-reportable open interest in the contract."
    }
  },
  "required": [
    "market_and_exchange_names",
    "report_date_as_yyyy_mm_dd",
    "cftc_contract_market_code",
    "open_interest_all"
  ]
}