Skip to content
Skills Library
Finance & accounting · Research

cot-positioning

/cot-positioning

Show who holds US futures from the CFTC's weekly Commitments of Traders report - net positions of large speculators, commercial hedgers and small traders in gold, silver, copper, crude oil, natural gas, S&P 500 and Nasdaq futures, Treasury notes, the dollar, euro, yen and Bitcoin (or any contract by search) - with the three-year COT index and weekly changes. Use when the user asks about COT data, speculator or hedge fund positioning in a commodity or currency, whether a futures market is crowded, or commercial hedger activity.

Licence
MIT
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/cot_report.py

What it does and when to use it

Show who holds US futures from the CFTC's weekly Commitments of Traders report - net positions of large speculators, commercial hedgers and small traders in gold, silver, copper, crude oil, natural gas, S&P 500 and Nasdaq futures, Treasury notes, the dollar, euro, yen and Bitcoin (or any contract by search) - with the three-year COT index and weekly changes. Use when the user asks about COT data, speculator or hedge fund positioning in a commodity or currency, whether a futures market is crowded, or commercial hedger activity.

Original author description

Show who holds US futures from the CFTC's weekly Commitments of Traders report - net positions of large speculators, commercial hedgers and small traders in gold, silver, copper, crude oil, natural gas, S&P 500 and Nasdaq futures, Treasury notes, the dollar, euro, yen and Bitcoin (or any contract by search) - with the three-year COT index and weekly changes. Use when the user asks about COT data, speculator or hedge fund positioning in a commodity or currency, whether a futures market is crowded, or commercial hedger activity.

How it works

  1. Output
  2. Interpreting it
  3. Limits
Original SKILL.md headings · 30 lines, 232 words
SKILL.md preview
---
name: cot-positioning
description: Show who holds US futures from the CFTC's weekly Commitments of Traders report - net positions of large speculators, commercial hedgers and small traders in gold, silver, copper, crude oil, natural gas, S&P 500 and Nasdaq futures, Treasury notes, the dollar, euro, yen and Bitcoin (or any contract by search) - with the three-year COT index and weekly changes. Use when the user asks about COT data, speculator or hedge fund positioning in a commodity or currency, whether a futures market is crowded, or commercial hedger activity.
---

# COT Positioning

```bash
python scripts/cot_report.py --market gold
python scripts/cot_report.py --market crude_wti --market natural_gas
python scripts/cot_report.py --all
python scripts/cot_report.py --search "SOYBEAN"        # find a contract code
python scripts/cot_report.py --code 005602
```

Built-in markets: gold, silver, copper, crude_wti, natural_gas, sp500_emini, nasdaq100_emini, us_10y_note, us_dollar_index, euro_fx, japanese_yen, bitcoin.

## Output

Per market: report date, open interest, speculator net (contracts and percent of open interest), speculator and commercial COT index (0 = lowest net in three years, 100 = highest), small-trader net, one- and four-week change in speculator net, and (single market) a 12-week history.

## Interpreting it

- **Speculators** (funds) tend to follow trends; **commercials** (producers and users hedging) tend to be on the other side.
- A speculator COT index near 100 means funds are as long as they have been in three years. Many traders read extremes as crowded and prone to sharp reversal; that is an interpretation, and extremes can last months while the trend continues. Present it as context and attribute the contrarian reading.
- The weekly change shows whether positioning is building or unwinding.
- For Indian commodity traders, US positioning in gold, silver, crude and copper matters because MCX follows international prices (`commodity-regime` shows the USD/INR link).

Positions are as of Tuesday, published Friday: always state the report date.

## Limits

Legacy futures-only report (no options or disaggregated categories). US exchanges only; there is no public equivalent for MCX.
Files in this package (2)
  • SKILL.md 2 KB
  • scripts/cot_report.py 3 KB

Versions

The database has no other skills named cot-positioning.

Database snapshot: 13.11.2026 · package version d1bcef3907b6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100cot-contrarian-detector
    Detect crowded speculative positioning in CFTC futures markets (COT report analysis) to find contrarian setups using Jason Shapiro's methodology. Screens large-speculator ("non-commercial") net positioning across 65 futures markets (indices, rates, FX, metals, energy, crypto)…
  • 100cot-contrarian-detector
    Detect crowded speculative positioning in CFTC futures markets (COT report analysis) to find contrarian setups using Jason Shapiro's methodology. Screens large-speculator ("non-commercial") net positioning across 65 futures markets (indices, rates, FX, metals, energy, crypto)…
  • 100commodity-regime
    Read the commodity and currency backdrop - trend and one-year range position of gold, silver, copper, WTI and Brent crude, natural gas, platinum, the dollar index and USD/INR; the gold/silver, gold/copper, gold/crude and Brent/WTI ratios with percentiles; and international…
  • 100crypto-regime
    Read the crypto market regime - Bitcoin, Ethereum, Solana and other coins' trend, drawdown from the five-year peak, 30-day realised volatility and correlation with the Nasdaq, the ETH/BTC ratio, and large-speculator positioning in CME Bitcoin futures from the CFTC. Use when the…
  • 90position-limit-reporting-cftc-large-trader
    Use for self-surveillance of US futures and options positions against CFTC large-trader reporting levels in 17 CFR 15.03 and Part 150 speculative position limits, aggregating sub-accounts before the carrying broker reports.
  • 100alterlab-hedgefund-monitor
    Queries the OFR (Office of Financial Research) Hedge Fund Monitor API for time series on hedge fund size, leverage, counterparties, liquidity, complexity, and risk management, including SEC Form PF aggregated statistics, CFTC Traders in Financial Futures, FICC Sponsored Repo…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.