{"uid":"cap_43iq4W-RiXBEFYj9nmLAD","slug":"gloom-cot-commitments-of-traders-data-api-c6ad2f07","name":"Gloom COT (Commitments of Traders) Data API","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?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":[{"position":{"id":"noncommercial","net":100,"long":300,"label":"Noncommercial","short":200,"spreading":0},"reportDate":"2026-09-29","contractCode":"000001","exchangeCode":"ILLUSTRATIVE","openInterest":1000,"commodityCode":"ILLUSTRATIVE"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_STGOALffqhlP-ipkesrZq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves CFTC Commitments of Traders (COT) report data including long, short, spreading, and net positions by trader category for futures contracts.","exampleAgentPrompt":"Pull the latest Commitments of Traders report data from Gloom for the crude oil futures contract — I want to see the noncommercial net, long, and short positions along with open interest.","exampleUseCases":[{"title":"Speculator sentiment in gold futures","prompt":"What are the current noncommercial net positions in gold futures according to the latest COT report? I want to see long, short, and spreading breakdown."},{"title":"COT positioning for currency futures analysis","prompt":"Get me the most recent Commitments of Traders data for the Euro FX futures contract so I can see how speculators are positioned heading into the ECB meeting."},{"title":"Open interest monitoring for agricultural commodities","prompt":"Fetch the COT report for corn futures — I need the open interest and the noncommercial versus commercial position breakdown to see if there's been a big shift in speculator exposure."}],"resultDescription":"Returns an array of COT report entries, each containing: report date, contract code, exchange code, commodity code, open interest, and a position object broken down by trader category (e.g. noncommercial) with id, label, net, long, short, and spreading values.","failureModes":["Invalid or unrecognized contract/commodity code returns empty data array","Malformed properties filter parameter may return 400 error","COT data may lag real-time markets since CFTC publishes weekly; most recent report date may be several days old","Rate limiting or payment failure (x402) if USDC payment is not supplied","Requesting a date before available history may return no data"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable CFTC Commitments of Traders positioning data for futures markets — particularly when building sentiment indicators, market analysis tools, or monitoring speculator positioning shifts. Prefer over scraping CFTC's website directly for clean JSON output with categorized positions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:43.354Z","isFirstParty":false,"canonicalSlug":"gloom-cot-commitments-of-traders-data-api-c6ad2f07"}