Skip to content
Eden Engine

CFTC Commitments of Traders: Legacy Futures-Only Weekly Positions

cftc/cot-legacy-futures-only

Weekly Commitments of Traders positions from the U.S. Commodity Futures Trading Commission's Legacy report, futures-only version: open interest and the long, short and spread positions of commercial, non-commercial and non-reportable traders, per futures market and report date, with weekly changes, percentages of open interest, trader counts and concentration ratios. A row count is required. Narrow to one market or date range with a SoQL where clause and sort with order. Every number arrives as a string and report dates are timestamps without a time zone. Government data, served by Eden Engine; not an official CFTC product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

U.S. Commodity Futures Trading Commission

Source: U.S. Commodity Futures Trading Commission (CFTC), Commitments of Traders. U.S. government data in the public domain; credit is a courtesy, not a requirement. Served by Eden Engine; not an official CFTC product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "cftc/cot-legacy-futures-only" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "cftc/cot-legacy-futures-only" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "cftc/cot-legacy-futures-only", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "cftc/cot-legacy-futures-only", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "limit"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "How many rows to return, 1 to 50. Each row holds well over a hundred columns, so ask for only as many as you need."
    },
    "order": {
      "type": "string",
      "pattern": "^[a-z0-9_]+( (asc|desc|ASC|DESC))?(, ?[a-z0-9_]+( (asc|desc|ASC|DESC))?)*$",
      "maxLength": 200,
      "description": "Optional SoQL sort, for example report_date_as_yyyy_mm_dd DESC for the newest weeks first. Without it, rows come back in the dataset's own order, which is not newest first."
    },
    "where": {
      "type": "string",
      "maxLength": 400,
      "minLength": 1,
      "description": "Optional SoQL filter on the dataset's columns, for example contract_market_name = 'WHEAT-SRW' or report_date_as_yyyy_mm_dd = '2022-09-13T00:00:00.000'. Other columns include commodity_name, commodity_group_name and cftc_contract_market_code. Combine tests with AND."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Optional number of rows to skip, to read the next page after a first one."
    },
    "select": {
      "type": "string",
      "pattern": "^[a-z0-9_]+(, ?[a-z0-9_]+){0,29}$",
      "maxLength": 800,
      "description": "Optional comma-separated list of column names to return instead of all of them, for example contract_market_name,report_date_as_yyyy_mm_dd,open_interest_all. Keeps the answer small."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Row id: the report date, the market code, then F for futures-only."
          },
          "commodity_name": {
            "type": "string"
          },
          "contract_units": {
            "type": "string"
          },
          "cftc_market_code": {
            "type": "string",
            "description": "Exchange code; carries a trailing space."
          },
          "open_interest_all": {
            "type": "string",
            "description": "Total open interest, as a string."
          },
          "futonly_or_combined": {
            "type": "string",
            "description": "FutOnly on every row of this dataset."
          },
          "yyyy_report_week_ww": {
            "type": "string",
            "description": "Report week label."
          },
          "commodity_group_name": {
            "type": "string"
          },
          "contract_market_name": {
            "type": "string",
            "description": "Contract market name."
          },
          "comm_positions_long_all": {
            "type": "string"
          },
          "comm_positions_short_all": {
            "type": "string"
          },
          "cftc_contract_market_code": {
            "type": "string"
          },
          "market_and_exchange_names": {
            "type": "string",
            "description": "Market and exchange, for example WHEAT-SRW - CHICAGO BOARD OF TRADE."
          },
          "report_date_as_yyyy_mm_dd": {
            "type": "string",
            "description": "Report date as a timestamp with no time zone."
          },
          "noncomm_positions_long_all": {
            "type": "string"
          },
          "nonrept_positions_long_all": {
            "type": "string"
          },
          "change_in_open_interest_all": {
            "type": "string"
          },
          "noncomm_positions_short_all": {
            "type": "string"
          },
          "noncomm_postions_spread_all": {
            "type": "string",
            "description": "Non-commercial spread positions; the column name is spelled this way upstream."
          },
          "nonrept_positions_short_all": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "description": "One object per market and report date, as the CFTC dataset reports it. Empty when the filter matches nothing. Every value is a string. With a select, only the chosen columns are present."
    }
  },
  "additionalProperties": true
}