{"uid":"cap_oHmXZyPK4hksIuLV_GcE8","slug":"x402stock-cftc-commitments-of-traders-cot-report-dc28f8af","name":"x402stock CFTC Commitments of Traders (COT) Report","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/cot/%7Bmarket%7D","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"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["weeks"],"properties":{"weeks":{"type":"integer","default":12,"maximum":52,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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}}}}},"responseSchema":{"type":"json","example":{"name":"Gold","as_of":"2026-06-02T00:00:00.000Z","group":"metals","latest":{"commercial":{"net":-206345,"long":53851,"short":260196,"long_change":-20790,"short_change":-211},"report_date":"2026-06-02","noncommercial":{"net":176020,"long":206096,"short":30076,"spreading":22449,"long_change":5392,"short_change":-16368},"nonreportable":{"net":30325,"long":43656,"short":13331},"open_interest":326052,"total_traders":258,"open_interest_change":-27437},"market":"gold","report":"legacy_futures_only","source":"cftc","history":[{"report_date":"2026-06-02","open_interest":326052,"commercial_net":-206345,"noncommercial_net":176020}],"attribution":"Source: U.S. Commodity Futures Trading Commission (CFTC) Commitments of Traders","contract_code":"088691"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_73fT_msZBnD79xtG3Up9K","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) data for a specified futures market, including net positions for commercial, non-commercial, and non-reportable traders, with historical weekly data.","exampleAgentPrompt":"Pull the latest CFTC Commitments of Traders report for gold, showing the last 12 weeks of commercial and non-commercial net positioning history.","exampleUseCases":null,"resultDescription":"Returns the latest COT report for the requested market including: open interest and change, commercial (long/short/net/changes), non-commercial (long/short/spreading/net/changes), non-reportable positions, total trader count, report date, contract code, market group classification, and a historical weekly series of net positions for the requested number of weeks. Also includes source attribution to the CFTC.","failureModes":["Invalid or unsupported market name in path returns 404 or error","weeks parameter out of range (must be 1-52) returns validation error","Payment not fulfilled via x402/USDC results in 402 Payment Required","Market data temporarily unavailable returns 503 or empty response","CFTC report not yet published for current week returns stale or null as_of date"],"whenToPreferThis":"Use this endpoint when you need structured CFTC COT positioning data for futures markets including equity indices, metals, energy, forex, rates, and crypto. Ideal for sentiment analysis, contrarian trading signals, or monitoring institutional vs speculative positioning trends. Prefer over raw CFTC downloads when you need clean, parsed, ready-to-use JSON with historical series in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:55:05.660Z","isFirstParty":false}