CFTC
Commitments of Traders: posisi long/short per kategori pelaku di tiap pasar berjangka Amerika, terbit tiap Jumat untuk posisi hari Selasa.
Commitments of Traders
Baris COT terbaru, bisa disaring per nama kontrak dan tanggal laporan. Net non-commercial dan commercial dihitung di sini.
/v1/finance:cftc/commitmentsParameters
| Name | Type | In | Description |
|---|---|---|---|
| market | string | query | Match against the contract name (case-insensitive substring). |
| from | string | query | Earliest report date (YYYY-MM-DD). |
| length | number | query | Rows to return (default 50, max 500). |
Example response
{"project":"finance:cftc", "data": {"from":"2026-01-01","count":50, "items": [ {"date":"2026-08-11","market":"GULF # 6 FUEL OIL CRACK","exchange":"GULF # 6 FUEL OIL CRACK - NEW YORK MERCANTILE EXCHANGE","commodity":"FUEL OIL/CRUDE OIL","openInterest":10102,"commercialNet":-263,"commercialLong":7142,"commercialShort":7405,"nonCommercialNet":253,"nonCommercialLong":1405,"nonReportableLong":10,"nonCommercialShort":1152,"nonReportableShort":0,"nonCommercialSpread":1545 }, {"date":"2026-08-11","market":"GULF JET NY HEAT OIL SPR","exchange":"GULF JET NY HEAT OIL SPR - NEW YORK MERCANTILE EXCHANGE","commodity":"JET FUEL/HEATING OIL","openInterest":12106,"commercialNet":-290,"commercialLong":11816,"commercialShort":12106,"nonCommercialNet":100,"nonCommercialLong":100,"nonReportableLong":190,"nonCommercialShort":0,"nonReportableShort":0,"nonCommercialSpread":0 }, {"date":"2026-08-11","market":"PGP PROPYLENE (PCW) CAL","exchange":"PGP PROPYLENE (PCW) CAL - NEW YORK MERCANTILE EXCHANGE","commodity":"PROPYLENE","openInterest":7012,"commercialNet":3127,"commercialLong":4028,"commercialShort":901,"nonCommercialNet":-3181,"nonCommercialLong":1841,"nonReportableLong":198,"nonCommercialShort":5022,"nonReportableShort":144,"nonCommercialSpread":945 }, {"date":"2026-08-11","market":"7 YEAR ERIS SOFR SWAP","exchange":"7 YEAR ERIS SOFR SWAP - CHICAGO BOARD OF TRADE","commodity":"2-7-YEAR INTEREST RATE SWAPS ERIS & MAC","openInterest":33099,"commercialNet":-6584,"commercialLong":375,"commercialShort":6959,"nonCommercialNet":6582,"nonCommercialLong":16239,"nonReportableLong":18,"nonCommercialShort":9657,"nonReportableShort":16,"nonCommercialSpread":16467 }, {"date":"2026-08-11","market":"5 YEAR ERIS SOFR SWAP","exchange":"5 YEAR ERIS SOFR SWAP - CHICAGO BOARD OF TRADE","commodity":"2-7-YEAR INTEREST RATE SWAPS ERIS & MAC","openInterest":177800,"commercialNet":-16936,"commercialLong":27204,"commercialShort":44140,"nonCommercialNet":16990,"nonCommercialLong":103512,"nonReportableLong":34,"nonCommercialShort":86522,"nonReportableShort":88,"nonCommercialSpread":47050 }, {"date":"2026-08-11","market":"3 YEAR ERIS SOFR SWAP","exchange":"3 YEAR ERIS SOFR SWAP - CHICAGO BOARD OF TRADE","commodity":"2-7-YEAR INTEREST RATE SWAPS ERIS & MAC","openInterest":71913,"commercialNet":-18005,"commercialLong":4500,"commercialShort":22505,"nonCommercialNet":18049,"nonCommercialLong":53345,"nonReportableLong":10,"nonCommercialShort":35296,"nonReportableShort":54,"nonCommercialSpread":14058 } ],"source":"cftc" },"timestamp":"2026-08-08T10:10:23Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Disaggregated
Commitments of Traders, disaggregated report — producer/merchant, swap dealer,
/v1/finance:cftc/disaggregatedParameters
| Name | Type | In | Description |
|---|---|---|---|
| market | string | query | Match against the contract name (case-insensitive substring). |
| code | string | query | Exact CFTC contract market code. The `markets` endpoint lists codes by commodity group. |
| from | string | query | Earliest report date, YYYY-MM-DD. History runs from 2006-06-13. |
| to | string | query | Latest report date, YYYY-MM-DD. |
| combined | enum | query | `true` for the futures-and-options combined report, `false` (default) for futures only. One of true, false. |
| subgroup | string | query | CFTC subgroup code, e.g. A10 grains, N16 currencies. Omit for every subgroup. |
| fields | string | query | Comma-separated column groups: `positions`, `changes`, `percent`, `traders`, `concentration`, `maturity`. Default `positions`. Use `all` for every one of the 191 published columns — slower and much larger. |
| page | number | query | Page number, 1-based. Default 1. |
| length | number | query | Rows per page (default 50, max 1000). |
Example response
{"project":"finance:cftc", "data": {"to":null,"code":null,"from":null,"page":1,"count":50, "items": [ {"code":"001602","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-SRW","exchange":"WHEAT-SRW - CHICAGO BOARD OF TRADE","subgroup":"A10","commodity":"WHEAT","openInterest":475566,"swapDealerNet":75386,"swapDealerLong":89805,"managedMoneyNet":-33400,"swapDealerShort":14419,"managedMoneyLong":78009,"swapDealerSpread":17099,"managedMoneyShort":111409,"nonReportableLong":38571,"managedMoneySpread":112454,"nonReportableShort":36415,"otherReportableNet":8490,"otherReportableLong":36970,"producerMerchantNet":-52632,"totalReportableLong":436995,"otherReportableShort":28480,"producerMerchantLong":64948,"totalReportableShort":439151,"otherReportableSpread":37710,"producerMerchantShort":117580 }, {"code":"001612","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-HRW","exchange":"WHEAT-HRW - CHICAGO BOARD OF TRADE","subgroup":"A10","commodity":"WHEAT","openInterest":305725,"swapDealerNet":79057,"swapDealerLong":80670,"managedMoneyNet":25606,"swapDealerShort":1613,"managedMoneyLong":63122,"swapDealerSpread":6701,"managedMoneyShort":37516,"nonReportableLong":22400,"managedMoneySpread":69568,"nonReportableShort":20540,"otherReportableNet":-12392,"otherReportableLong":8810,"producerMerchantNet":-94131,"totalReportableLong":283325,"otherReportableShort":21202,"producerMerchantLong":27784,"totalReportableShort":285185,"otherReportableSpread":26670,"producerMerchantShort":121915 }, {"code":"001626","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-HRSpring","exchange":"WHEAT-HRSpring - MIAX FUTURES EXCHANGE","subgroup":"A10","commodity":"WHEAT","openInterest":81898,"swapDealerNet":7571,"swapDealerLong":7571,"managedMoneyNet":9879,"swapDealerShort":0,"managedMoneyLong":17591,"swapDealerSpread":127,"managedMoneyShort":7712,"nonReportableLong":8649,"managedMoneySpread":4941,"nonReportableShort":7719,"otherReportableNet":-220,"otherReportableLong":1447,"producerMerchantNet":-18160,"totalReportableLong":73249,"otherReportableShort":1667,"producerMerchantLong":39913,"totalReportableShort":74179,"otherReportableSpread":1659,"producerMerchantShort":58073 } ],"total":183676, "fields": [ "positions" ],"market":null,"dataset":"disaggregated","hasMore":true,"combined":false,"nextPage":2,"provider":"cftc","subgroup":null },"timestamp":"2026-08-08T10:10:23Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Legacy
Commitments of Traders, legacy report — the non-commercial / commercial split.
/v1/finance:cftc/legacyParameters
| Name | Type | In | Description |
|---|---|---|---|
| market | string | query | Match against the contract name (case-insensitive substring). |
| code | string | query | Exact CFTC contract market code. The `markets` endpoint lists codes by commodity group. |
| from | string | query | Earliest report date, YYYY-MM-DD. History runs from 1986-01-15. |
| to | string | query | Latest report date, YYYY-MM-DD. |
| combined | enum | query | `true` for the futures-and-options combined report, `false` (default) for futures only. One of true, false. |
| fields | string | query | Comma-separated column groups: `positions`, `changes`, `percent`, `traders`, `concentration`, `maturity`. Default `positions`. Use `all` for every one of the 130 published columns — slower and much larger. |
| page | number | query | Page number, 1-based. Default 1. |
| length | number | query | Rows per page (default 50, max 1000). |
Example response
{"project":"finance:cftc", "data": {"to":null,"code":null,"from":null,"page":1,"count":50, "items": [ {"code":"001602","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-SRW","exchange":"WHEAT-SRW - CHICAGO BOARD OF TRADE","commodity":"WHEAT","openInterest":475566,"commercialNet":22754,"commercialLong":171852,"commercialShort":149098,"nonCommercialNet":-24910,"nonCommercialLong":114979,"nonReportableLong":38571,"nonCommercialShort":139889,"nonReportableShort":36415,"nonCommercialSpread":150164,"totalReportableLong":436995,"totalReportableShort":439151 }, {"code":"001612","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-HRW","exchange":"WHEAT-HRW - CHICAGO BOARD OF TRADE","commodity":"WHEAT","openInterest":305725,"commercialNet":-15074,"commercialLong":115155,"commercialShort":130229,"nonCommercialNet":13214,"nonCommercialLong":71932,"nonReportableLong":22400,"nonCommercialShort":58718,"nonReportableShort":20540,"nonCommercialSpread":96238,"totalReportableLong":283325,"totalReportableShort":285185 }, {"code":"001626","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-HRSpring","exchange":"WHEAT-HRSpring - MIAX FUTURES EXCHANGE","commodity":"WHEAT","openInterest":81898,"commercialNet":-10589,"commercialLong":47611,"commercialShort":58200,"nonCommercialNet":9659,"nonCommercialLong":19038,"nonReportableLong":8649,"nonCommercialShort":9379,"nonReportableShort":7719,"nonCommercialSpread":6600,"totalReportableLong":73249,"totalReportableShort":74179 } ],"total":287411, "fields": [ "positions" ],"market":null,"dataset":"legacy","hasMore":true,"combined":false,"nextPage":2,"provider":"cftc" },"timestamp":"2026-08-08T10:10:23Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Markets
The contract catalog behind every COT report: which commodity a contract market
/v1/finance:cftc/marketsParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Match against the commodity name (case-insensitive substring). |
| group | enum | query | Commodity group to keep. One of AGRICULTURE, NATURAL RESOURCES, FINANCIAL INSTRUMENTS. |
| subgroup | string | query | Commodity subgroup to keep, e.g. PRECIOUS METALS, GRAINS, CURRENCIES. |
| code | string | query | Exact CFTC contract market code. |
| page | number | query | Page number, 1-based. Default 1. |
| length | number | query | Rows per page (default 50, max 1000). |
Example response
{"project":"finance:cftc", "data": {"code":null,"page":1,"count":50,"group":null, "items": [ {"code":"001601","group":"AGRICULTURE","subgroup":"GRAINS","commodity":"WHEAT" }, {"code":"001602","group":"AGRICULTURE","subgroup":"GRAINS","commodity":"WHEAT" }, {"code":"001603","group":"AGRICULTURE","subgroup":"GRAINS","commodity":"WHEAT" }, {"code":"001604","group":"AGRICULTURE","subgroup":"GRAINS","commodity":"WHEAT" }, {"code":"001605","group":"AGRICULTURE","subgroup":"GRAINS","commodity":"WHEAT" }, {"code":"001606","group":"AGRICULTURE","subgroup":"GRAINS","commodity":"WHEAT" } ],"query":null,"total":31419,"dataset":"markets","hasMore":true,"nextPage":2,"provider":"cftc","subgroup":null },"timestamp":"2026-08-08T10:10:23Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Supplemental
Supplemental Commitments of Traders — the commodity index trader split.
/v1/finance:cftc/supplementalParameters
| Name | Type | In | Description |
|---|---|---|---|
| market | string | query | Match against the contract name (case-insensitive substring). |
| code | string | query | Exact CFTC contract market code. The `markets` endpoint lists codes by commodity group. |
| from | string | query | Earliest report date, YYYY-MM-DD. History runs from 2006-01-03. |
| to | string | query | Latest report date, YYYY-MM-DD. |
| fields | string | query | Comma-separated column groups: `positions`, `changes`, `percent`, `traders`. Default `positions`. Use `all` for every one of the 57 published columns — slower and much larger. |
| page | number | query | Page number, 1-based. Default 1. |
| length | number | query | Rows per page (default 50, max 1000). |
Example response
{"project":"finance:cftc", "data": {"to":null,"code":null,"from":null,"page":1,"count":50, "items": [ {"code":"001602","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-SRW","exchange":"WHEAT-SRW - CHICAGO BOARD OF TRADE","commodity":"WHEAT","openInterest":581798,"commercialNet":-23057,"commercialLong":120646,"indexTraderNet":68913,"commercialShort":143703,"indexTraderLong":142641,"indexTraderShort":73728,"nonCommercialNet":-49398,"nonCommercialLong":56834,"nonReportableLong":42424,"nonCommercialShort":106232,"nonReportableShort":38881,"nonCommercialSpread":219254,"totalReportableLong":539374,"totalReportableShort":542917 }, {"code":"001612","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"WHEAT-HRW","exchange":"WHEAT-HRW - CHICAGO BOARD OF TRADE","commodity":"WHEAT","openInterest":345187,"commercialNet":-68743,"commercialLong":63494,"indexTraderNet":65843,"commercialShort":132237,"indexTraderLong":90389,"indexTraderShort":24546,"nonCommercialNet":900,"nonCommercialLong":48119,"nonReportableLong":24416,"nonCommercialShort":47219,"nonReportableShort":22418,"nonCommercialSpread":118767,"totalReportableLong":320771,"totalReportableShort":322769 }, {"code":"002602","date":"2026-08-11","units":"(CONTRACTS OF 5,000 BUSHELS)","market":"CORN","exchange":"CORN - CHICAGO BOARD OF TRADE","commodity":"CORN","openInterest":2268704,"commercialNet":-332403,"commercialLong":661727,"indexTraderNet":338165,"commercialShort":994130,"indexTraderLong":463958,"indexTraderShort":125793,"nonCommercialNet":38993,"nonCommercialLong":242139,"nonReportableLong":184239,"nonCommercialShort":203146,"nonReportableShort":228995,"nonCommercialSpread":716640,"totalReportableLong":2084464,"totalReportableShort":2039709 } ],"total":13610, "fields": [ "positions" ],"market":null,"dataset":"supplemental","hasMore":true,"nextPage":2,"provider":"cftc" },"timestamp":"2026-08-08T10:10:23Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
TFF
Traders in Financial Futures — dealer, asset manager, leveraged money and
/v1/finance:cftc/tffParameters
| Name | Type | In | Description |
|---|---|---|---|
| market | string | query | Match against the contract name (case-insensitive substring). |
| code | string | query | Exact CFTC contract market code. The `markets` endpoint lists codes by commodity group. |
| from | string | query | Earliest report date, YYYY-MM-DD. History runs from 2006-06-13. |
| to | string | query | Latest report date, YYYY-MM-DD. |
| combined | enum | query | `true` for the futures-and-options combined report, `false` (default) for futures only. One of true, false. |
| subgroup | string | query | CFTC subgroup code, e.g. A10 grains, N16 currencies. Omit for every subgroup. |
| fields | string | query | Comma-separated column groups: `positions`, `changes`, `percent`, `traders`, `concentration`. Default `positions`. Use `all` for every one of the 87 published columns — slower and much larger. |
| page | number | query | Page number, 1-based. Default 1. |
| length | number | query | Rows per page (default 50, max 1000). |
Example response
{"project":"finance:cftc", "data": {"to":null,"code":null,"from":null,"page":1,"count":50, "items": [ {"code":"020601","date":"2026-08-11","units":"(CONTRACTS OF $100,000 FACE VALUE)","market":"UST BOND","exchange":"UST BOND - CHICAGO BOARD OF TRADE","subgroup":"F30","commodity":"T-BONDS","dealerNet":-243296,"dealerLong":23520,"dealerShort":266816,"dealerSpread":8677,"openInterest":1862944,"assetManagerNet":549650,"assetManagerLong":1061726,"assetManagerShort":512076,"leveragedMoneyNet":-364824,"nonReportableLong":233127,"assetManagerSpread":260156,"leveragedMoneyLong":148363,"nonReportableShort":160627,"otherReportableNet":-14030,"leveragedMoneyShort":513187,"otherReportableLong":103695,"totalReportableLong":1629817,"leveragedMoneySpread":23636,"otherReportableShort":117725,"totalReportableShort":1702317,"otherReportableSpread":44 }, {"code":"020604","date":"2026-08-11","units":"(CONTRACTS OF $100,000 FACE VALUE)","market":"ULTRA UST BOND","exchange":"ULTRA UST BOND - CHICAGO BOARD OF TRADE","subgroup":"F30","commodity":"T-BONDS","dealerNet":-227262,"dealerLong":21953,"dealerShort":249215,"dealerSpread":5216,"openInterest":2416703,"assetManagerNet":1080409,"assetManagerLong":1647210,"assetManagerShort":566801,"leveragedMoneyNet":-853397,"nonReportableLong":193169,"assetManagerSpread":379043,"leveragedMoneyLong":82626,"nonReportableShort":191645,"otherReportableNet":-1274,"leveragedMoneyShort":936023,"otherReportableLong":37137,"totalReportableLong":2223534,"leveragedMoneySpread":50318,"otherReportableShort":38411,"totalReportableShort":2225058,"otherReportableSpread":31 }, {"code":"042601","date":"2026-08-11","units":"(CONTRACTS OF $200,000 FACE VALUE)","market":"UST 2Y NOTE","exchange":"UST 2Y NOTE - CHICAGO BOARD OF TRADE","subgroup":"F30","commodity":"T-NOTES, 1-2 YEAR","dealerNet":-480452,"dealerLong":123637,"dealerShort":604089,"dealerSpread":31830,"openInterest":4377812,"assetManagerNet":1680389,"assetManagerLong":2342975,"assetManagerShort":662586,"leveragedMoneyNet":-1359521,"nonReportableLong":215176,"assetManagerSpread":561141,"leveragedMoneyLong":618328,"nonReportableShort":167368,"otherReportableNet":111776,"leveragedMoneyShort":1977849,"otherReportableLong":333428,"totalReportableLong":4162636,"leveragedMoneySpread":151061,"otherReportableShort":221652,"totalReportableShort":4210444,"otherReportableSpread":236 } ],"total":46174, "fields": [ "positions" ],"market":null,"dataset":"tff","hasMore":true,"combined":false,"nextPage":2,"provider":"cftc","subgroup":null },"timestamp":"2026-08-08T10:10:23Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:cftc", "commitments", { market: "WHEAT", from: "2026-01-01", length: 50 });
CFTC
Commitments of Traders: posisi long/short per kategori pelaku di tiap pasar berjangka Amerika, terbit tiap Jumat untuk posisi hari Selasa.
Baris COT terbaru, bisa disaring per nama kontrak dan tanggal laporan. Net non-commercial dan commercial dihitung di sini.
/v1/…cftc/commitmentsTry it
Parameters
market
string · query · optional
Match against the contract name (case-insensitive substring).
from
string · query · optional
Earliest report date (YYYY-MM-DD).
length
number · query · optional
Rows to return (default 50, max 500).
Example response
{"project":"finance:cftc", "data": {"from":"2026-01-01","count":50, "items": [ {"date":"2026-08-11","market":"GULF # 6 FUEL OIL CRACK","exchange":"GULF # 6 FUEL OIL CRACK - NEW YORK MERCANTILE EXCHANGE","commodity":"FUEL OIL/CRUDE OIL","openInterest":10102,"commercialNet":-263,"commercialLong":7142,"commercialShort":7405,"nonCommercialNet":253,"nonCommercialLong":1405,"nonReportableLong":10,"nonCommercialShort":1152,"nonReportableShort":0,"nonCommercialSpread":1545 }, {"date":"2026-08-11","market":"GULF JET NY HEAT OIL SPR","exchange":"GULF JET NY HEAT OIL SPR - NEW YORK MERCANTILE EXCHANGE","commodity":"JET FUEL/HEATING OIL","openInterest":12106,"commercialNet":-290,"commercialLong":11816,"commercialShort":12106,"nonCommercialNet":100,"nonCommercialLong":100,"nonReportableLong":190,"nonCommercialShort":0,"nonReportableShort":0,"nonCommercialSpread":0 }, {"date":"2026-08-11","market":"PGP PROPYLENE (PCW) CAL","exchange":"PGP PROPYLENE (PCW) CAL - NEW YORK MERCANTILE EXCHANGE","commodity":"PROPYLENE","openInterest":7012,"commercialNet":3127,"commercialLong":4028,"commercialShort":901,"nonCommercialNet":-3181,"nonCommercialLong":1841,"nonReportableLong":198,"nonCommercialShort":5022,"nonReportableShort":144,"nonCommercialSpread":945 }, {"date":"2026-08-11","market":"7 YEAR ERIS SOFR SWAP","exchange":"7 YEAR ERIS SOFR SWAP - CHICAGO BOARD OF TRADE","commodity":"2-7-YEAR INTEREST RATE SWAPS ERIS & MAC","openInterest":33099,"commercialNet":-6584,"commercialLong":375,"commercialShort":6959,"nonCommercialNet":6582,"nonCommercialLong":16239,"nonReportableLong":18,"nonCommercialShort":9657,"nonReportableShort":16,"nonCommercialSpread":16467 }, {"date":"2026-08-11","market":"5 YEAR ERIS SOFR SWAP","exchange":"5 YEAR ERIS SOFR SWAP - CHICAGO BOARD OF TRADE","commodity":"2-7-YEAR INTEREST RATE SWAPS ERIS & MAC","openInterest":177800,"commercialNet":-16936,"commercialLong":27204,"commercialShort":44140,"nonCommercialNet":16990,"nonCommercialLong":103512,"nonReportableLong":34,"nonCommercialShort":86522,"nonReportableShort":88,"nonCommercialSpread":47050 }, {"date":"2026-08-11","market":"3 YEAR ERIS SOFR SWAP","exchange":"3 YEAR ERIS SOFR SWAP - CHICAGO BOARD OF TRADE","commodity":"2-7-YEAR INTEREST RATE SWAPS ERIS & MAC","openInterest":71913,"commercialNet":-18005,"commercialLong":4500,"commercialShort":22505,"nonCommercialNet":18049,"nonCommercialLong":53345,"nonReportableLong":10,"nonCommercialShort":35296,"nonReportableShort":54,"nonCommercialSpread":14058 } ],"source":"cftc" },"timestamp":"2026-08-08T10:10:23Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:cftc", "commitments", { market: "WHEAT", from: "2026-01-01", length: 50 });