{"uid":"cap_cpVtSdBmXiboLOwhM_xzA","slug":"market-intelligence-api-cftc-cot-futures-positioning-5e63c4d5","name":"Market Intelligence API – CFTC COT Futures Positioning","description":"Use for the futures positioning behind one market ($0.005): CFTC Commitments of Traders weekly history for gold, WTI, S&P 500, Nasdaq, Treasuries, EUR, JPY, bitcoin, ether and more (aliases GOLD, SPY, BTC, EURUSD work): speculators, hedgers and small traders net, 1w/4w change, COT index 0-100 and CROWDED_LONG/SHORT.","url":"https://api.marketintelligenceapi.com/api/v1/cot/gold?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["market"],"properties":{"market":{"type":"string","examples":["gold"],"description":"Market key, alias or CFTC code, e.g. gold"}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"weeks":{"type":"integer","default":26,"maximum":156,"minimum":4,"description":"Weeks of history (4-156)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0q60NYesqiyMwPWz12LEQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns CFTC Commitments of Traders (COT) weekly positioning data for a specified futures market, including speculator/hedger/small-trader net positions, 1-week and 4-week changes, COT index (0-100), and crowded long/short signals.","exampleAgentPrompt":"What's the current CFTC COT positioning for gold — are large speculators crowded long or short, and where does the COT index sit right now?","exampleUseCases":[{"title":"Contrarian trade signal from crowded positioning","prompt":"Check the COT positioning for the S&P 500 — are large speculators at an extreme long or short, and what's the COT index reading? I want to know if the market is crowded."},{"title":"Bitcoin sentiment from futures positioning","prompt":"Pull the latest CFTC Commitments of Traders data for bitcoin futures — I need speculator net positions, the 1-week and 4-week change, and whether we're seeing a crowded long or short signal."},{"title":"EUR/USD macro positioning check","prompt":"What does the COT data look like for EUR/USD? Specifically the speculator net position versus hedgers, and how it's shifted over the past 4 weeks."}],"resultDescription":"Returns a JSON object with: speculator, hedger, and small-trader net positions; 1-week and 4-week net position changes; a COT index value from 0 to 100 indicating historical extremes; and a CROWDED_LONG or CROWDED_SHORT signal where applicable, all for the requested futures market.","failureModes":["Invalid or unrecognized symbol returns an error or empty result","Rate limiting or payment failure (x402) if USDC balance is insufficient","Stale data if CFTC has not yet published the latest weekly report","Network timeout on the upstream API","Symbol alias not mapping to a supported market"],"whenToPreferThis":"Use this endpoint when you need institutional-grade futures positioning sentiment — specifically CFTC COT data with speculator/hedger breakdowns, historical COT index, and crowded trade signals — for macro assets including commodities (gold, WTI), equity indices (S&P 500, Nasdaq), rates (Treasuries), FX (EUR, JPY), and crypto (BTC, ETH). Prefer this over generic price or sentiment APIs when the goal is understanding positioning extremes and contrarian signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:51:20.713Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-cftc-cot-futures-positioning-5e63c4d5"}