Disaggregated COT report
Detailed breakdown: Producer/Merchant (physical hedgers), Swap Dealers, Managed Money (hedge funds, CTAs), Other Reportables. Shows what hedge funds (managed money) are doing vs physical hedgers. Set combined=true for Futures + Options report (default Futures-Only).
Query parameters
Filter by market name
Filter by market name
True = Combined (Futures + Options); False (default) = Futures-Only.
True = Combined (Futures + Options); False (default) = Futures-Only.
Max records (raise with a market filter to pull full history)
Max records (raise with a market filter to pull full history)
Inclusive report-date lower bound, ISO YYYY-MM-DD.
Inclusive report-date lower bound, ISO YYYY-MM-DD.
Inclusive report-date upper bound, ISO YYYY-MM-DD.
Inclusive report-date upper bound, ISO YYYY-MM-DD.
Response
Disaggregated COT positions by Producer/Merchant, Swap Dealers, Managed Money, and Other Reportables.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}Changes
Changed in 2 of the 21 revisions of this API.812
- ▲
the response property
data/combinedbecame optional for the status200response-property-became-optional
- ▲
the response property
data/countbecame optional for the status200response-property-became-optional
- ▲
the response property
data/recordsbecame optional for the status200response-property-became-optional
- ▲
the response property
data/report_typebecame optional for the status200response-property-became-optional
- ▲
response property
data/combinedlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
data/countlist-of-types was widened by adding typesnull and numberto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
data/recordslist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
- ▲
response property
data/report_typelist-of-types was widened by adding typesnullto media typeapplication/jsonof response200response-property-list-of-types-widened
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ▲
- ○
added the optional property
codeto the response with the401statusresponse-optional-property-added
- ○
added the optional property
codeto the response with the429statusresponse-optional-property-added
- ○
added the optional property
codeto the response with the503statusresponse-optional-property-added
- ○
added the optional property
hintto the response with the401statusresponse-optional-property-added
- ○
added the optional property
hintto the response with the429statusresponse-optional-property-added
- ○
added the optional property
hintto the response with the503statusresponse-optional-property-added
- ○
added the optional property
planto the response with the401statusresponse-optional-property-added
- ○
added the optional property
planto the response with the429statusresponse-optional-property-added
- ○
added the optional property
planto the response with the503statusresponse-optional-property-added
- ○
added the optional property
reasonto the response with the401statusresponse-optional-property-added
- ○
added the optional property
reasonto the response with the429statusresponse-optional-property-added
- ○
added the optional property
reasonto the response with the503statusresponse-optional-property-added
- ○