{"uid":"cap_B50jvJePG4X9barn-cIsv","slug":"vextorium-futures-positioning-cftc-cot-data-d2f313ec","name":"Vextorium Futures Positioning (CFTC COT Data)","description":"244 pay-per-call data APIs for AI agents: official statistics and economy (ECB, Fed, Eurostat, World Bank, SEC, BOE, INE), crypto prices and sentiment, Spanish public data, compliance (sanctions, VAT, IBAN, LEI), science, weather, web and developer tools and local AI text tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/futures-positioning?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"weeks":{"type":"integer","description":"Weeks of history, 1-26 (default 4)"},"market":{"type":"string","description":"Market name or part of it: GOLD, CRUDE OIL, E-MINI S&P 500, BITCOIN, EURO FX..."}}},"responseSchema":{"type":"json","example":{"query":"GOLD","report":"Legacy, futures only, weekly (Tuesday positions)","source":"Source: U.S. Commodity Futures Trading Commission, Commitments of Traders (public domain). Not endorsed by the CFTC.","markets":[{"market":"GOLD - COMMODITY EXCHANGE INC.","history":[{"commercials":{"net":-242531,"long":54419,"short":296950},"report_date":"2026-10-13","open_interest":396345,"small_traders":{"long":50731,"short":16079},"large_speculators":{"net":207879,"long":245300,"short":37421,"spreading":45895},"change_open_interest":236},{"commercials":{"net":-244527,"long":55802,"short":300329},"report_date":"2026-10-06","open_interest":396109,"small_traders":{"long":50464,"short":16272},"large_speculators":{"net":210335,"long":245403,"short":35068,"spreading":44440},"change_open_interest":-10347}],"contract_code":"088691"},{"market":"MICRO GOLD - COMMODITY EXCHANGE INC.","history":[{"commercials":{"net":8027,"long":8027,"short":0},"report_date":"2026-10-13","open_interest":110505,"small_traders":{"long":44752,"short":24721},"large_speculators":{"net":-28058,"long":52364,"short":80422,"spreading":5362},"change_open_interest":9209},{"commercials":{"net":8131,"long":8131,"short":0},"report_date":"2026-10-06","open_interest":101296,"small_traders":{"long":44091,"short":25210},"large_speculators":{"net":-27012,"long":46462,"short":73474,"spreading":2612},"change_open_interest":-194}],"contract_code":"088695"}],"latest_report_date":"2026-10-13"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_D2lZVDyrKixXswgu-18su","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","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) futures positioning data — long, short, and net positions for commercials, large speculators, and small traders — for a given market and history window.","exampleAgentPrompt":"Pull the CFTC Commitments of Traders positioning data for GOLD futures for the last 8 weeks — I want to see how commercials and large speculators are positioned.","exampleUseCases":[{"title":"Tracking speculator sentiment in crude oil","prompt":"Show me the last 12 weeks of CFTC COT data for CRUDE OIL futures — I want to see whether large speculators are building or cutting their net long position."},{"title":"Monitoring commercial hedging in gold","prompt":"What are the current commercial and large speculator net positions in GOLD futures according to the latest CFTC Commitments of Traders report? Show me the last 4 weeks."},{"title":"Checking Bitcoin futures positioning","prompt":"Get me the CFTC COT futures positioning data for BITCOIN for the past 6 weeks — I want to know if large speculators are net long or short right now."}],"resultDescription":"A JSON object containing one or more matching markets, each with a history array of weekly COT snapshots. Each snapshot includes the report date, total open interest, change in open interest, and long/short/net/spreading positions for commercials, large speculators, and small traders. Also includes the source attribution and the date of the latest available report.","failureModes":["Market name not found — returns empty markets array if the search term doesn't match any CFTC market","Weeks parameter out of range (must be 1–26) — may return error or clamp to valid range","Stale data — CFTC COT data is weekly (released Fridays for Tuesday positions), so the latest report may be up to a week old","Multiple markets returned — a broad search term like 'GOLD' may return both GOLD and MICRO GOLD contracts","No data for very recent weeks — if the latest report hasn't been processed yet, history may be shorter than requested"],"whenToPreferThis":"Use this endpoint when you need weekly CFTC Commitments of Traders (COT) data for futures markets including commodities (gold, crude oil), equity indices (E-Mini S&P 500), currencies (Euro FX), or crypto (Bitcoin). It provides structured JSON with historical weekly snapshots broken down by trader category (commercials, large speculators, small traders), which is ideal for sentiment analysis, market positioning research, or macro trading signals. Prefer this over scraping CFTC's website directly or parsing raw COT report files.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T13:02:45.478Z","isFirstParty":false,"canonicalSlug":"vextorium-futures-positioning-cftc-cot-data-d2f313ec"}