{"uid":"cap_wmmSoaKz6Et9kC6aC4Jtp","slug":"x402stock-cftc-commitments-of-traders-cot-by-market-ee1432df","name":"x402stock CFTC Commitments of Traders (COT) by Market","description":"CFTC Commitments of Traders for one futures market by slug: sp500, nasdaq, gold, silver, crude-oil, natural-gas, euro, british-pound, japanese-yen, swiss-franc, us-dollar-index, 10y-note, bitcoin. Returns open interest and non-commercial, commercial, and non-reportable long/short/net with weekly changes plus net history. `?weeks=` 12 (max 52). From the US CFTC. From x402stock","url":"https://agents.x402stock.xyz/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"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","market":{"type":"string"}},"queryParams":{"type":"object","properties":{"weeks":{"type":"integer","default":12,"maximum":52,"exclusiveMinimum":0}}}},"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_VGBE-XTQ-t4khIH_sLgsh","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 the latest CFTC Commitments of Traders report data for a specified futures market, including open interest, non-commercial/commercial/non-reportable long/short/net positions, weekly changes, and net position history.","exampleAgentPrompt":"Pull the CFTC Commitments of Traders report for crude oil futures for the last 24 weeks — I want to see open interest, non-commercial and commercial net positions, and how they've changed week over week.","exampleUseCases":[{"title":"Speculator positioning in gold futures","prompt":"Show me the COT data for gold futures over the last 20 weeks — I want to know whether large speculators are net long or short and how that's trended recently."},{"title":"Equity index futures sentiment check","prompt":"What does the latest CFTC Commitments of Traders report say about S&P 500 futures? Give me 12 weeks of history so I can see if non-commercial positioning is turning bullish or bearish."},{"title":"Forex positioning for euro vs. dollar","prompt":"Pull the COT report for euro futures for the past 8 weeks — I'm trying to see how commercial and non-commercial traders are positioned heading into the ECB meeting."}],"resultDescription":"Returns structured COT report data for the requested futures market, including total open interest, and long, short, and net position counts (plus weekly changes) for non-commercial (large speculators), commercial, and non-reportable (small traders) categories. Also includes a historical series of net positions for up to 52 weeks.","failureModes":["Invalid market slug returns an error or empty response — only the 13 predefined slugs (sp500, nasdaq, gold, silver, crude-oil, natural-gas, euro, british-pound, japanese-yen, swiss-franc, us-dollar-index, 10y-note, bitcoin) are supported","weeks parameter exceeding 52 is rejected (schema maximum)","weeks=0 is rejected (exclusiveMinimum:0)","Payment failure (402) if USDC payment is not properly attached","Data may be delayed by up to a week as CFTC releases COT reports weekly on Fridays"],"whenToPreferThis":"Use this endpoint when you need structured, per-market CFTC COT positioning data for a specific supported futures market (commodities, FX, equity indices, crypto, or rates) with historical weekly series. Prefer this over scraping the CFTC website directly because it returns clean structured data with net position history. Best for market sentiment analysis, contrarian trading signals, or macro positioning research on any of the 13 supported markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T18:47:22.566Z","isFirstParty":false,"canonicalSlug":"x402stock-cftc-commitments-of-traders-cot-by-market-ee1432df"}