{"uid":"cap_iiVOusFiAYQi_GLEcTIYb","slug":"gloom-cot-commitments-of-traders-data-by-contract-8eca9044","name":"Gloom COT (Commitments of Traders) Data by Contract","description":"Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.","url":"https://api.gloom.sh/v1/cot/%7BcontractCode%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"scope":"futures-only","contract":{"contractCode":"000001","exchangeCode":"ILLUSTRATIVE","commodityCode":"ILLUSTRATIVE"},"positions":[{"id":"noncommercial","net":100,"long":300,"label":"Noncommercial","short":200,"spreading":0}],"sourceUrl":null,"openInterest":1000,"reportFamily":"legacy"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KexQldCJdwXk4_M0NGC0Q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","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) report data for a specific futures contract, including long/short/spreading positions by trader category and open interest.","exampleAgentPrompt":"Can you pull the latest Commitments of Traders report for contract code 000001 and show me the noncommercial long, short, and net positions along with total open interest?","exampleUseCases":[{"title":"Speculator sentiment check for crude oil","prompt":"Fetch the COT data for the WTI crude oil futures contract and tell me whether noncommercial traders are net long or net short right now, and by how much."},{"title":"Open interest monitoring for gold futures","prompt":"What's the current open interest and how are the different trader categories positioned in the gold futures contract according to the latest COT report?"},{"title":"Commodity positioning research for portfolio analysis","prompt":"I'm researching corn futures — can you get me the legacy COT report breakdown showing long, short, and spreading positions for each trader category for the corn futures contract?"}],"resultDescription":"A JSON object containing the COT report for the requested contract, including: report scope (e.g. futures-only), contract metadata (contractCode, exchangeCode, commodityCode), an array of trader-category position objects (each with id, label, net, long, short, spreading values), total open interest, report family (e.g. legacy), and an optional sourceUrl linking to the original CFTC filing.","failureModes":["Invalid or unknown contractCode returns an error or empty data","Contract code for a non-futures instrument may return no results or scope mismatch","Payment failure (x402) if USDC balance is insufficient — returns 402 status","Rate limiting if too many requests are made in quick succession","Data may be delayed or unavailable if CFTC has not yet published the latest weekly report"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable CFTC Commitments of Traders data for a specific futures contract, broken down by trader category (noncommercial, commercial, etc.), and want to avoid scraping the CFTC website manually. It is ideal for quantitative analysis of speculator positioning, open interest trends, and market sentiment in commodity and financial futures markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:42.453Z","isFirstParty":false,"canonicalSlug":"gloom-cot-commitments-of-traders-data-by-contract-8eca9044"}