{"uid":"cap_MsXlKtdvgDXLTJR3Rhaip","slug":"bykaranteli-cftc-cot-weekly-history-199df1e7","name":"ByKaranteli CFTC COT Weekly History","description":"CFTC Commitments of Traders weekly history for crypto futures with the columns the free CSV does not carry: dealer long and short books and week-over-week change in open interest, alongside every participant class. The free CC0 download covers hedge fund, institutional, other reportable and small trader positions.","url":"https://bykaranteli.com/api/x402/cot-history?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"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"date, optional"},"from":{"type":"string","description":"date, optional"},"limit":{"type":"number","description":"number, optional, max 3000"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[],"count":500,"dataset":"cot-history"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kF_Asy3VSQa6DqXWA4hai","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns full weekly CFTC Commitments of Traders history for crypto futures, including dealer, asset manager, leveraged fund, other reportable, and non-reportable long/short positions plus open interest.","exampleAgentPrompt":"Pull the CFTC COT weekly history for BTC from 2023-01-01 to 2024-01-01 and show me the leveraged fund long and short positions along with open interest — limit to 100 rows.","exampleUseCases":[{"title":"Institutional positioning trend analysis","prompt":"Get me the full CFTC COT history for ETH futures for the last 6 months — I want to see how asset managers and leveraged funds have been shifting their long and short positions over time."},{"title":"Crypto futures sentiment dashboard","prompt":"Pull the CFTC commitments of traders weekly history for BTC and SOL going back to 2022 so I can build a chart of dealer versus leveraged fund positioning alongside open interest."},{"title":"Regulatory position snapshot for research report","prompt":"Fetch the most recent 50 CFTC COT weekly reports for Bitcoin futures — I need the dealer, asset manager, and non-reportable long and short numbers for a research report on crypto market structure."}],"resultDescription":"A JSON object with an `ok` flag, a `dataset` label ('cot-history'), a `count` of rows returned, and a `rows` array where each row contains weekly CFTC position breakdowns by trader category (dealer, asset manager, leveraged fund, other reportable, non-reportable) with long and short values plus open interest, filtered by symbol, currency, exchange, and date window as specified.","failureModes":["Invalid or unsupported symbol returns empty rows array","Date range produces no matching reports (future dates or pre-data era)","Limit parameter exceeds dataset cap, silently capped","Missing required method or type fields in input schema returns validation error","Payment failure (402) if USDC balance insufficient for the $0.005 per-call fee"],"whenToPreferThis":"Choose this endpoint when you need historical weekly CFTC Commitments of Traders data specifically for crypto futures markets, with breakdown by trader category (dealer, asset manager, leveraged fund). Prefer it over general market data endpoints when regulatory position reporting, institutional sentiment analysis, or COT-based trading signals are the goal. It is particularly suited for backtesting COT-based strategies or building dashboards that track how different market participants have positioned over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:34:05.684Z","isFirstParty":false,"canonicalSlug":"bykaranteli-cftc-cot-weekly-history-199df1e7"}