# COT (Commitments of Traders)

CFTC Commitments of Traders futures positioning, agent-callable. One call takes a market (crude, gold, silver, copper, natgas, corn, wheat, soybeans, sp500, nasdaq, euro, yen, pound, bitcoin, 10y, bonds, sofr...) and returns a positioning signal (Crowded Long / Lean Long / Neutral / Lean Short / Crowded Short) driven by where the large speculators' net position sits vs its own 3-year history - the classic contrarian read (crowded long precedes mean-reversion; crowded short precedes a squeeze). Returns large-spec long/short/net with 3-year percentile, commercial (hedger) net on the other side, small-trader net, week-over-week change and open interest. The TradFi/commodity-futures analog of the FundingRates / OpenInterest positioning cluster, pay-per-call. $0.05 via x402 on Base or Solana. Source: CFTC Public Reporting (free), Legacy Futures-Only, released weekly. | Companion: FundingRates + OpenInterest + Liquidations | Full catalog: lonestaroracle.xyz

Base URL: https://cot.lonestaroracle.xyz
Payment: x402 micropayment in USDC on Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp); a 402 response returns payment terms.

## Endpoints
### GET /cot?market=<name>
CFTC Commitments of Traders positioning for a market. Required param: market (friendly name e.g. gold / crude / sp500 / euro / 10y / bitcoin; aliases commodity, symbol, m).

## Related services
- RatesPulse (rates.lonestaroracle.xyz, $0.05) - US yield curve, credit spreads, real yields
- FundingRates (funding.lonestaroracle.xyz, $0.05) - perp funding rates + extremes
- OpenInterest (oi.lonestaroracle.xyz, $0.05) - crypto open interest + extremes
- MacroPulse (macro.lonestaroracle.xyz, $0.05) - US macro dashboard
- AgriPulse (agri.lonestaroracle.xyz, $0.03) - ag commodity prices

Agent manual (SKILL.md): https://cot.lonestaroracle.xyz/SKILL.md