{"uid":"cap_iciIOtvxdMI50EktniWnh","slug":"2s-io-cftc-commitments-of-traders-cot-api-8fea4baa","name":"2s.io CFTC Commitments of Traders (COT) API","description":"CFTC Commitments of Traders (COT) — weekly futures positioning for a market (free/keyless). Match a market by name (e.g. 'E-MINI S&P', 'GOLD', 'CRUDE OIL', 'BITCOIN'). Each weekly report: open interest, large speculators (non-commercial) long/short/spread, commercials (hedgers) long/short, small (non-reportable) traders, and week-over-week changes. For positioning/sentiment analysis.","url":"https://2s.io/api/econ/cot","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["market"],"properties":{"limit":{"type":"integer","maximum":50,"minimum":1},"market":{"type":"string","maxLength":60,"minLength":2,"description":"Market name contains, e.g. GOLD, E-MINI S&P, CRUDE OIL."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0045","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.0045/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nDnHosBnZ2V6hHq54Zqoh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0045","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns weekly CFTC COT futures positioning data for a named market, including open interest, large speculator, commercial hedger, and small trader positions with week-over-week changes.","exampleAgentPrompt":"Pull the last 4 weekly CFTC COT reports for CRUDE OIL futures — I want to see open interest, how large speculators and commercials are positioned, and how those positions have shifted week over week.","exampleUseCases":[{"title":"Gold futures speculator sentiment check","prompt":"Pull the latest COT report for gold futures and tell me whether large speculators are net long or short, and how their positioning has changed compared to last week."},{"title":"S&P 500 contrarian positioning signal","prompt":"Grab the most recent CFTC commitments of traders data for E-mini S&P futures — I want to see what large speculators and commercial hedgers are doing and whether sentiment looks stretched in either direction."},{"title":"Bitcoin futures sentiment trend","prompt":"Get me the last few weekly COT reports for Bitcoin futures so I can track how speculator positioning and open interest have been trending recently."}],"resultDescription":"Returns one or more weekly COT report entries for the matched market, each containing: open interest, non-commercial (large speculator) long/short/spread positions, commercial (hedger) long/short positions, non-reportable (small trader) positions, and week-over-week changes for each category.","failureModes":["Market name does not match any known CFTC market — returns empty or error response","Ambiguous market name matches multiple markets — may return unexpected results","CFTC data not yet published for the current week — most recent report may be up to 7 days old","Limit parameter exceeds maximum of 50 — request rejected","Payment failure or insufficient USDC balance — 402 response"],"whenToPreferThis":"Use this endpoint when you need official CFTC futures positioning data (COT reports) for a specific commodity, index, or financial futures market. Ideal for sentiment analysis, contrarian trading signals, and tracking speculator vs. hedger positioning trends. Prefer over generic financial APIs when you specifically need structured COT data by market name without requiring an API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:12:38.608Z","isFirstParty":false}