{"uid":"cap_VdANUYQObC_LmE7EK07wG","slug":"saylor-innovations-cftc-commitments-of-traders-api-ca7100b5","name":"Saylor Innovations CFTC Commitments of Traders API","description":"CFTC Commitments of Traders for any futures market - speculator, hedger and small trader long, short and net positions, open interest and weekly change","url":"https://saylorinnovations.com/api/futures/cot?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["market"],"properties":{"weeks":{"type":"string","description":"optional 1-26, default 8"},"market":{"type":"string","description":"Market name fragment, e.g. GOLD, CRUDE OIL, E-MINI S&P, EURO FX, BITCOIN"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["market","latest","history"],"properties":{"note":{"type":"string","description":"Caveat or context for reading the result"},"latest":{"type":"object","description":"Most recent value or version"},"market":{"type":"string","description":"Market details"},"source":{"type":"string","description":"Data source the values come from"},"history":{"type":"array","description":"Historical values, in time order"},"commodity":{"type":["string","null"],"description":"Market name matched in the CFTC Commitments of Traders report"},"contract_code":{"type":"string","description":"Contract code"},"latest_report":{"type":"string","description":"Latest report"},"other_matching_markets":{"type":"array","description":"Other matching markets"}}}}}}},"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_FP6MB7g85XS1Ba8aMj3ZQ","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) report data for any futures market, including speculator, hedger and small trader positions, open interest, and weekly changes.","exampleAgentPrompt":"Pull the last 12 weeks of CFTC Commitments of Traders data for CRUDE OIL futures — I want to see the speculator, hedger and small trader net positions and open interest over time.","exampleUseCases":[{"title":"Tracking gold speculator sentiment","prompt":"Show me the last 8 weeks of CFTC COT data for GOLD futures — I want to know if large speculators are increasing or decreasing their net long positions."},{"title":"Monitoring crypto futures positioning","prompt":"Get me the current Commitments of Traders report for BITCOIN futures, including hedger and speculator positions and the change from last week."},{"title":"Macro research on S&P futures","prompt":"Pull 26 weeks of COT data for E-MINI S&P futures so I can see how commercial hedgers and large speculators have been positioned over the past six months."}],"resultDescription":"Returns a JSON object with the matched market name, contract code, latest report date, the most recent COT breakdown (speculator long/short/net, hedger long/short/net, small trader long/short/net, open interest, weekly changes), a history array of up to 26 weeks of the same data in chronological order, data source attribution, optional contextual notes, and any other matching markets found.","failureModes":["Market name fragment matches no known CFTC market — returns empty or null commodity field","Ambiguous market name matches multiple markets — returns other_matching_markets list requiring refinement","CFTC source data not yet updated for the current week — latest_report reflects prior release date","Invalid weeks parameter (outside 1-26) — may return default 8 weeks or an error","Network timeout or upstream CFTC data unavailability"],"whenToPreferThis":"Choose this endpoint when you need structured, parsed CFTC COT positioning data for any futures market without manually downloading and parsing CFTC weekly reports. Ideal for monitoring speculator vs hedger sentiment shifts, building COT-based trading signals, or enriching macro analysis with positioning context. Preferable to raw CFTC downloads when you need JSON-formatted, historically arrayed data on demand for a specific market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:24:38.331Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-cftc-commitments-of-traders-api-ca7100b5"}