[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [CFTC index trader positions](https://spiral.ai/integrations/instinct/cftc-index-trader-positions)

# How to Use CFTC index trader positions in Instinct

Returns CFTC agricultural positioning data, including index trader longs and shorts, open interest, weekly changes, and trader counts. Use it to compare index positioning with commercial and noncommercial positions across 13 futures-and-options markets.

|  |  |
| --- | --- |
| Model | CFTC index trader positions |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.001746 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with CFTC index trader positions in Instinct

- Each week, use CFTC index trader positions to check for a new corn report. When one appears, summarize index longs, shorts, net positions, and their changes from the previous report.
- Every week, use CFTC index trader positions to compare soybeans, soybean oil, and soybean meal. Report changes in index long positions as a share of open interest.
- After each new report, use CFTC index trader positions to review lean hogs, live cattle, and feeder cattle. Flag any change in index net positions exceeding 10,000 contracts.
- Weekly, use CFTC index trader positions to compare cotton's latest index net position with its previous 52 available reports. Tell me when it reaches a new high or low for that period.
- Each month, use CFTC index trader positions to summarize coffee, cocoa, and sugar No. 11. Show the first and last available report dates, index net positions, and category trader counts.

## How to set up CFTC index trader positions in Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run CFTC index trader positions**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "cftc/supplemental/index-traders",
    "input": {
      "$limit": 1000
    }
  }'
```

Then paste one of the prompts above: Instinct finds CFTC index trader positions on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## CFTC index trader positions tools and prices

- [CFTC · Supplemental report, commodity index traders](https://spiral.ai/tools/alexandria/cftc/supplemental/index-traders) (Alexandria): $0.001746 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| $limit |  | 1000 | Rows to return. The default is 1,000; the datasets hold hundreds of thousands, so a date or market filter is what keeps a page useful rather than this. |
| $where |  | — | A SoQL filter for anything the column filters cannot say: `report_date_as_yyyy_mm_dd > '2026-01-01' AND commodity_name = 'GOLD'`, `open_interest_all > 100000`, `market_and_exchange_names like '%CRUDE%'`. An unknown column answers HTTP 400 with the failing query echoed back. |
| $offset |  | — | Rows to skip, for paging past `$limit`. |
| $select |  | — | Columns to return, comma-separated, in place of all of them. `count(*)` on its own answers how many rows match. A selected subset no longer matches the declared fields, so read the declared list as what the full row carries. |
| commodity_name |  | — | Commodity name, `GOLD` or `CRUDE OIL`. Exact match, upper case. One commodity can span several markets. |
| cftc_market_code |  | — | Exchange code: `CBT`, `CME`, `NYME`, `CMX`, `ICUS`, `ICEU`. Exact match, and unreliable on its own: a quarter of the rows store the code with trailing spaces (`CMX ` beside `CMX`, the latest gold row among them), and equality on `CMX` misses every one of those. Filter on `cftc_contract_market_code` instead, or use `$where=cftc_market_code like 'CMX%'`. |

## What can you do with CFTC index trader positions in Instinct?

Produce a recurring agricultural positioning brief when CFTC publishes a new report. A scheduled agent can compare successive reporting dates and flag changes in index exposure or its share of open interest.

### Weekly agricultural positioning brief

Summarize changes in index trader longs, shorts, and calculated net positions across the covered contracts for a commodity research meeting.

### Index participation comparison

Compare index trader long positions as a share of open interest in corn, soybeans, and wheat to show differences in participation.

### Historical positioning ranges

Calculate where current corn or cotton index net positions sit within their available five-year history.

### Commercial and index position comparison

Compare weekly commercial and index net position changes in sugar or coffee for a procurement team's market briefing.

### Livestock positioning monitor

Track index longs and shorts in lean hogs, live cattle, and feeder cattle, highlighting the largest weekly changes.

### Commodity research dataset

Build a dated table of open interest and positions by trader category for historical analysis, keeping each contract separate.

### Participation change review

Compare category trader counts with position changes in cocoa and cotton to distinguish changes in participation from changes in aggregate exposure.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## CFTC index trader positions in other agents

- [Amp](https://spiral.ai/integrations/amp/cftc-index-trader-positions)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/cftc-index-trader-positions)
- [Claude](https://spiral.ai/integrations/claude-desktop/cftc-index-trader-positions)
- [Claude Code](https://spiral.ai/integrations/claude-code/cftc-index-trader-positions)
- [Cline](https://spiral.ai/integrations/cline/cftc-index-trader-positions)
- [Codex](https://spiral.ai/integrations/codex/cftc-index-trader-positions)
- [Cursor](https://spiral.ai/integrations/cursor/cftc-index-trader-positions)
- [Devin](https://spiral.ai/integrations/devin/cftc-index-trader-positions)
- [dots](https://spiral.ai/integrations/dots/cftc-index-trader-positions)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/cftc-index-trader-positions)
- [Gemini](https://spiral.ai/integrations/gemini/cftc-index-trader-positions)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/cftc-index-trader-positions)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/cftc-index-trader-positions)
- [goose](https://spiral.ai/integrations/goose/cftc-index-trader-positions)
- [Grok](https://spiral.ai/integrations/grok/cftc-index-trader-positions)
- [Grok Build](https://spiral.ai/integrations/grok-build/cftc-index-trader-positions)
- [Hermes](https://spiral.ai/integrations/hermes/cftc-index-trader-positions)
- [Manus](https://spiral.ai/integrations/manus/cftc-index-trader-positions)
- [Muse](https://spiral.ai/integrations/muse/cftc-index-trader-positions)
- [Muse Code](https://spiral.ai/integrations/muse-code/cftc-index-trader-positions)
- [n8n](https://spiral.ai/integrations/n8n/cftc-index-trader-positions)
- [Notion](https://spiral.ai/integrations/notion/cftc-index-trader-positions)
- [OpenClaw](https://spiral.ai/integrations/openclaw/cftc-index-trader-positions)
- [opencode](https://spiral.ai/integrations/opencode/cftc-index-trader-positions)
- [Perplexity](https://spiral.ai/integrations/perplexity/cftc-index-trader-positions)
- [Raycast](https://spiral.ai/integrations/raycast/cftc-index-trader-positions)
- [VS Code](https://spiral.ai/integrations/vscode/cftc-index-trader-positions)
- [Windsurf](https://spiral.ai/integrations/windsurf/cftc-index-trader-positions)
- [Zapier](https://spiral.ai/integrations/zapier/cftc-index-trader-positions)

## More Instinct guides

- [CFTC futures positioning](https://spiral.ai/integrations/instinct/cftc-futures-positioning)
- [CFTC legacy futures and options positions](https://spiral.ai/integrations/instinct/cftc-legacy-futures-and-options-positions)
- [CFTC futures and options positioning](https://spiral.ai/integrations/instinct/cftc-futures-and-options-positioning)
- [CFTC legacy futures positions](https://spiral.ai/integrations/instinct/cftc-legacy-futures-positions)
- [CFTC financial futures positions](https://spiral.ai/integrations/instinct/cftc-financial-futures-positions)
- [CME FedWatch meeting probabilities](https://spiral.ai/integrations/instinct/cme-fedwatch-meeting-probabilities)

## Questions about CFTC index trader positions in Instinct

**Can Instinct use CFTC index trader positions?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run CFTC index trader positions like any built-in tool.

**How much does CFTC index trader positions cost in Instinct?**

$0.001746 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need an Alexandria account to use CFTC index trader positions in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs CFTC index trader positions on its own Alexandria account.

**How long does it take to set up CFTC index trader positions in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while CFTC index trader positions runs?**

CFTC index trader positions runs in the background. Instinct starts the run, checks on it and gives you the json when it's ready.

**Which markets does the CFTC Supplemental report cover?**

It covers 13 selected agricultural contracts with futures and options combined. Coverage includes grains, livestock, and soft commodities; gold, crude oil, and financial futures fall outside this report.

**How current are the positions?**

The usual release is Friday at 3:30 p.m. Eastern time and describes positions from the previous Tuesday. Federal holidays can delay publication by one or two days.

**How far back does the history go?**

CFTC's Commodity Index Trader Supplement archive starts in January 2006. Use that boundary when requesting historical comparisons.

**How are options counted alongside futures?**

CFTC converts options into futures-equivalent positions using delta factors supplied by exchanges. Combined position totals therefore include delta-adjusted options exposure.

**Does the index trader category measure index investment exactly?**

No. CFTC assigns all of a trader's positions according to the predominant strategy, so the Supplemental totals can overstate or understate actual index trading.

