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"
  ]
}