{"uid":"cap_o5blsHOxJdWTh4REyNzKi","slug":"cftc-commitments-of-traders-cot-positioning-signal-e6228c91","name":"CFTC Commitments of Traders (COT) Positioning Signal","description":"CFTC Commitments of Traders positioning for a market (?market=<name>)","url":"https://cot.lonestaroracle.xyz/cot?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"name":"COT","tags":["cot","futures","positioning","commitments-of-traders","commodities"],"type":"object","version":"1.0.0","category":"markets","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"market":{"type":"string","example":"gold","description":"Futures market to read. Friendly names accepted: crude, gold, silver, copper, natgas, corn, wheat, soybeans, sugar, coffee, cattle, sp500, nasdaq, russell, vix, euro, yen, pound, cad, aud, dollar, bitcoin, ether, 10y, 5y, bonds, sofr. Aliases: commodity, symbol, m."}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"query":"euro","market":"EURO FX - CHICAGO MERCANTILE EXCHANGE","source":"CFTC Commitments of Traders (publicreporting.cftc.gov)","cot_signal":"Crowded Short (contrarian bullish)","commercials":{"net":80000,"long":480000,"note":"commercials = hedgers/producers; typically the opposite side of large specs","short":400000,"net_pct_oi":9.8},"large_specs":{"net":-72447,"long":120000,"short":192447,"net_pct_oi":-8.8,"net_wow_change":-8100,"net_percentile_3y":0.9},"report_date":"2026-07-28","history_weeks":160,"oi_wow_change":12000,"open_interest":819806,"small_traders":{"net":-7553,"net_pct_oi":-0.9},"interpretation":"Large speculators are net short near a 3-year extreme (0.9th pct) — a crowded short that often precedes a squeeze/bounce."}}}},"description":"CFTC Commitments of Traders positioning made agent-callable. One x402 call takes a futures 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 versus its own 3-year history — the classic contrarian read (a crowded long often precedes mean-reversion; a crowded short often precedes a squeeze). Returns large-spec long/short/net with the 3-year percentile, the 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, served pay-per-call. $0.05 in USDC on Base via x402. Source: CFTC Public Reporting, Legacy Futures-Only report (free/public). Released weekly for the prior Tuesday."},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q6sa6Iqxy7uzQP2_fO3p0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns CFTC COT positioning data and a contrarian signal (Crowded Long/Short, Lean, Neutral) for a named futures market based on large speculator net position vs 3-year history","exampleAgentPrompt":"What's the current COT positioning signal for gold — are large speculators crowded long or short relative to their 3-year history, and what's the contrarian read?","exampleUseCases":[{"title":"Contrarian trade signal for crude oil","prompt":"Pull the COT positioning signal for crude oil futures — I want to know if large specs are at an extreme long or short relative to the past 3 years and what the contrarian interpretation is."},{"title":"Forex positioning check before a trade","prompt":"Check the commitments of traders data for the euro — are large speculators crowded short or long, and where does that put them on the 3-year percentile scale?"},{"title":"Multi-market positioning scan for a weekly report","prompt":"Get me the COT signal for bitcoin, gold, and the S&P 500 — I need to know which ones have specs near a positioning extreme so I can flag contrarian setups in my weekly note."}],"resultDescription":"Returns a JSON object with: the resolved market name, data source attribution (CFTC), a cot_signal label (Crowded Long / Lean Long / Neutral / Lean Short / Crowded Short), large speculator net position (long, short, net, net_pct_oi, net_wow_change, net_percentile_3y), commercial hedger net position, small trader net position, open interest, week-over-week OI change, report date, history weeks available, and a plain-English interpretation of what the positioning extreme means.","failureModes":["Unknown or unsupported market name returns an error — use accepted friendly names (crude, gold, euro, bitcoin, etc.)","CFTC source data may lag by 1 week (reports are released weekly, typically Tuesday)","Payment failure via x402 if insufficient USDC balance","Empty or null response if market data is temporarily unavailable from CFTC"],"whenToPreferThis":"Use this endpoint when you need CFTC COT-based contrarian positioning signals for futures markets — especially when assessing whether large speculators are at a historical extreme that may precede a reversal. Prefer this over general market data APIs when the specific question is about speculator positioning, crowded trades, or COT-based sentiment analysis across commodities, forex, equity indices, rates, or crypto futures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:37:18.473Z","isFirstParty":false,"canonicalSlug":"cftc-commitments-of-traders-cot-positioning-signal-e6228c91"}