{"uid":"cap_SCRVOCqyO0Nl01Vefo3oM","slug":"cftc-commitments-of-traders-cot-positioning-api-04466d3d","name":"CFTC Commitments of Traders (COT) Positioning API","description":"Returns CFTC Commitments of Traders positioning (non-commercial, commercial and small traders: long, short, net) for a futures market, with week-over-week change and optional history.","url":"https://macro-data-api-313m.onrender.com/v1/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["market"],"properties":{"weeks":{"type":"string","description":"Weeks of history, 1-260. Default 1."},"market":{"type":"string","description":"Market: ES, NQ, YM, RTY, GC, SI, CL, NG, 6E, 6J, 6B, 6S, ZN, BTC"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CbU6GtEAq0zJTvf51st3P","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","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 positioning data (non-commercial, commercial, and small trader long/short/net positions) for a specified futures market, with week-over-week changes and optional historical weeks.","exampleAgentPrompt":"What does the latest CFTC COT report say about speculator positioning in gold futures (GC) — give me the non-commercial long, short, and net positions along with the week-over-week change?","exampleUseCases":[{"title":"Speculator sentiment check for crude oil","prompt":"Pull the latest CFTC Commitments of Traders data for crude oil (CL) — I want to see what non-commercial traders are long, short, and net right now and how it changed from last week."},{"title":"12-week COT history for euro positioning","prompt":"Can you get me 12 weeks of COT positioning history for euro futures (6E) so I can see how speculative net longs have been trending?"},{"title":"Multi-trader breakdown for Bitcoin futures","prompt":"What's the current CFTC COT positioning breakdown for Bitcoin futures (BTC)? I want to see the non-commercial, commercial, and small trader positions with their net figures."}],"resultDescription":"Returns CFTC COT report data for the requested futures market including non-commercial (large speculator), commercial (hedger), and small trader long, short, and net position counts, week-over-week changes for each category, and optionally multiple weeks of historical data going back up to 260 weeks.","failureModes":["Invalid or unsupported market symbol returns an error — only specific tickers like ES, NQ, GC, CL, 6E are accepted","Weeks parameter out of range (less than 1 or greater than 260) may return an error or be clamped","CFTC data may lag by one week as reports are released weekly on Fridays","Service unavailability on Render hosting may cause timeouts or 503 errors","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need CFTC Commitments of Traders positioning data for major futures markets (equity indices, metals, energy, currencies, fixed income, or crypto) and want structured long/short/net breakdowns by trader category with week-over-week changes. Prefer this over scraping CFTC directly when you need clean, structured JSON output and optional historical time series. Best suited for macro analysis, sentiment tracking, and systematic trading research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T18:28:33.543Z","isFirstParty":false,"canonicalSlug":"cftc-commitments-of-traders-cot-positioning-api-04466d3d"}