{"uid":"cap_ij3NpfJGvN5F4v9Lz2rtN","slug":"cftc-commitments-of-traders-cot-data-by-market-baad1057","name":"CFTC Commitments of Traders (COT) Data by Market","description":"CFTC Commitments of Traders history for one market ($0.01): 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. Use for the futures positioning behind one market.","url":"https://api.marketintelligenceapi.com/api/v1/cot/:market?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":"One of 24 CFTC markets by key, alias or code: gold, silver, wti, natgas, sp500, nasdaq100, ust10y, eur, jpy, bitcoin, ether... (list: /api/v1/cot)."}},"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_TWRL5RCaJORfc39kU8pq5","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 weekly CFTC Commitments of Traders positioning data for a specific futures market, including speculator/hedger/small-trader net positions, 1w/4w changes, COT index, and crowded long/short signals.","exampleAgentPrompt":"What's the current CFTC futures positioning for gold — are speculators crowded long or short, and what's the COT index reading? Give me the last 8 weeks of history.","exampleUseCases":[{"title":"Pre-trade sentiment check for Bitcoin","prompt":"Before I size into a BTC position, check the CFTC COT data for bitcoin — are large speculators crowded long or short right now, and what's the COT index score?"},{"title":"Equity futures crowding risk before earnings","prompt":"I'm thinking about buying S&P 500 futures — can you pull the latest COT report for sp500 and tell me if speculator positioning is at an extreme, using the last 26 weeks of data?"},{"title":"FX positioning review for EUR trade","prompt":"Show me how leveraged funds are positioned in EUR futures according to the latest CFTC COT data, including the 1-week and 4-week change in net positions and whether it's a crowded trade."}],"resultDescription":"Returns a time series of weekly CFTC COT data for the requested market, including: net positions for speculators (large traders/managed money), commercial hedgers, and small traders; week-over-week and 4-week changes; a normalized COT index from 0 to 100 (0=historically max short, 100=historically max long); and a CROWDED_LONG or CROWDED_SHORT signal when positioning is at an extreme. Up to 156 weeks of history can be requested.","failureModes":["Unknown or unsupported market key returns an error — check /api/v1/cot for valid market list","Weeks parameter outside 4–156 range returns a validation error","CFTC data lag: COT reports are released weekly (Friday) with a Tuesday cutoff, so the latest week may be 3-5 days stale","Payment failure (x402 protocol) if wallet has insufficient USDC balance","Rate limiting if too many calls are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need institutional-grade futures positioning data (CFTC COT reports) for a specific asset — gold, WTI, S&P 500, Nasdaq, Treasuries, EUR, JPY, Bitcoin, Ether, or other supported markets. It's ideal for pre-trade sentiment checks, identifying crowded trades, or monitoring speculator positioning trends. Prefer it over general price feeds when the question is about market structure and positioning rather than current price. The COT index (0-100) and CROWDED signal make it especially useful for contrarian or momentum overlay strategies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:41:06.658Z","isFirstParty":false,"canonicalSlug":"cftc-commitments-of-traders-cot-data-by-market-baad1057"}