{"uid":"cap_ai5FhZXBTn_m0-B7zwkiw","slug":"agents-x402stock-xyz-cftc-commitments-of-traders-by-market-4e468e4a","name":"CFTC Commitments of Traders by Market","description":"Commitments of Traders for one futures market","url":"https://agents.x402stock.xyz/api/v1/cot/{market}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["market"],"properties":{"weeks":{"type":"integer","default":12,"maximum":52,"exclusiveMinimum":0},"market":{"type":"string","description":"CFTC Commitments-of-Traders market/commodity name."}}},"responseSchema":{"type":"object","required":["source","as_of","market","contract_code","name","group","latest","history","report","attribution"],"properties":{"name":{"type":"string"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"group":{"enum":["equity_index","metals","energy","fx","rates","crypto"],"type":"string"},"latest":{"anyOf":[{"type":"object","required":["report_date","open_interest","open_interest_change","noncommercial","commercial","nonreportable","total_traders"],"properties":{"commercial":{"type":"object","required":["long","short","net","long_change","short_change"],"properties":{"net":{"anyOf":[{"type":"number"},{"type":"null"}]},"long":{"anyOf":[{"type":"number"},{"type":"null"}]},"short":{"anyOf":[{"type":"number"},{"type":"null"}]},"long_change":{"anyOf":[{"type":"number"},{"type":"null"}]},"short_change":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"report_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"noncommercial":{"type":"object","required":["long","short","spreading","net","long_change","short_change"],"properties":{"net":{"anyOf":[{"type":"number"},{"type":"null"}]},"long":{"anyOf":[{"type":"number"},{"type":"null"}]},"short":{"anyOf":[{"type":"number"},{"type":"null"}]},"spreading":{"anyOf":[{"type":"number"},{"type":"null"}]},"long_change":{"anyOf":[{"type":"number"},{"type":"null"}]},"short_change":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"nonreportable":{"type":"object","required":["long","short","net"],"properties":{"net":{"anyOf":[{"type":"number"},{"type":"null"}]},"long":{"anyOf":[{"type":"number"},{"type":"null"}]},"short":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"open_interest":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_traders":{"anyOf":[{"type":"number"},{"type":"null"}]},"open_interest_change":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"market":{"type":"string"},"report":{"type":"string"},"source":{"type":"string","const":"cftc"},"history":{"type":"array","items":{"type":"object","required":["report_date","open_interest","noncommercial_net","commercial_net"],"properties":{"report_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"open_interest":{"anyOf":[{"type":"number"},{"type":"null"}]},"commercial_net":{"anyOf":[{"type":"number"},{"type":"null"}]},"noncommercial_net":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"attribution":{"type":"string"},"contract_code":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1ApeR2T7eWc_E5Bne7Te5","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-x402","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns CFTC Commitments of Traders (COT) report data for a specific futures market, including open interest and long/short/net positions for non-commercial, commercial, and non-reportable traders with weekly changes and historical net data.","exampleAgentPrompt":"Pull the latest CFTC Commitments of Traders data for gold futures, including the last 12 weeks of net position history, so I can see how commercial and non-commercial traders are positioned.","exampleUseCases":[{"title":"Tracking speculator positioning in oil","prompt":"What are large speculators doing in crude oil futures right now? Show me the CFTC COT data with 8 weeks of net position history so I can see if they've been increasing or cutting their longs."},{"title":"Monitoring currency futures sentiment","prompt":"Get me the latest CFTC Commitments of Traders report for the Japanese yen futures — I want to see the non-commercial net position and how it's changed week over week over the last 4 weeks."},{"title":"Bitcoin futures institutional positioning","prompt":"What does the latest CFTC COT report say about Bitcoin futures? Show me commercial and non-commercial long/short positions with 6 weeks of history so I can gauge institutional sentiment."}],"resultDescription":"A JSON object containing the market name, contract code, asset group classification, the latest COT report date, open interest and its weekly change, and broken-down long/short/net positions plus weekly changes for non-commercial (large speculators), commercial (hedgers), and non-reportable (small traders) participants. Also includes a historical array of net positions for up to 52 weeks, a source attribution, and the as-of date of the data.","failureModes":["Invalid market slug returns an error — must use exact slugs like 'sp500', 'crude-oil', 'bitcoin'","Weeks parameter exceeding 52 is rejected","CFTC data may be delayed (released weekly, typically Fridays) so latest report may lag current date by days","Payment failure if insufficient USDC balance for $0.01 per-call charge","Null fields in response if CFTC has not yet published data for the current week"],"whenToPreferThis":"Choose this endpoint when you need official US CFTC Commitments of Traders positioning data for supported futures markets (equity indices, metals, energy, FX, rates, crypto). It is ideal for analyzing market sentiment, tracking speculator vs. hedger positioning trends, and accessing historical net position series up to 52 weeks back. Prefer this over general market data endpoints when the specific question involves trader category breakdowns (commercial vs. non-commercial) from the official regulatory report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T06:41:14.156Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-cftc-commitments-of-traders-by-market-4e468e4a"}