What it returns
Weekly positioning of large traders in every US futures market, straight from the CFTC's official Commitments of Traders data (publicreporting.cftc.gov). Covers gold, crude oil, natural gas, grains, currencies, Treasuries, equity index futures, Bitcoin and hundreds more, with history back to 1986.
One row per market per weekly report: report date, market, contract code, exchange, commodity group, open interest, long/short/spread positions for every trader group, week-over-week changes, percent of open interest, trader counts and concentration ratios. Net positions are pre-computed (e.g. `managedMoneyNet`, `leveragedFundsNet`, `nonCommercialNet`).
Request
POST https://api.pushbuild.com/cftc-commitments-of-traders/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
report | string: legacy, disaggregated, financial | Which COT report format. Default: "legacy". |
includeOptions | boolean | Off: futures only. On: futures and options combined. Default: false. |
markets | list of strings | Text match on market name, e.g. GOLD, CRUDE OIL, E-MINI S&P 500, EURO FX, BITCOIN. |
contractCodes | list of strings | Exact CFTC contract market codes, e.g. 088691 (gold), 13874A (E-mini S&P 500). |
commodityGroup | string | e.g. NATURAL RESOURCES, AGRICULTURE, FINANCIAL INSTRUMENTS. |
exchangeCode | string | e.g. CME, CBT, NYME, CMX, ICUS. |
latestOnly | boolean | Only the most recent weekly report. Default: on when no dates are given. |
dateFrom | string | YYYY-MM-DD report date (Tuesday as-of date). |
dateTo | string | YYYY-MM-DD. |
sort | string: newest, oldest | Report date order. Default: "newest". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/cftc-commitments-of-traders/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"markets": ["GOLD"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Company Jobs API (Greenhouse, Lever, Ashby, Workable) API
Every open job straight from company career boards on Greenhouse, Lever, Ashby, Workable, SmartRecruiters and Recruitee: title, location, remote flag, department, employment type, posted date, salary where published, apply link and full description..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com