Skip to main content

cot

Get Commitment of Traders Reports.

Examples

from openbb import obb
obb.cftc.cot()
# Get the latest report for all items classified as, GOLD.
obb.cftc.cot(code='CFTC_088691', limit=1)
# Get the report for futures only.
obb.cftc.cot(code='CFTC_088691', futures_only=True, limit=1)
# Filter the report down to a specific section.
obb.cftc.cot(code='CFTC_088691', futures_only=True, measure='changes', limit=1)

Parameters

code: str
A string with the market code.

start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. Default is the most recent report.

end_date: date | None | str
End date of the data, in YYYY-MM-DD format.


Returns

results: COT

Serializable results.

provider: Optional[Literal['cftc']]

Provider name.

warnings: Optional[list[Warning_]]

list of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.


Data

date: date | str
The date of the data.

report_week: str | None
Report week for the year.

market_and_exchange_names: str | None
Market and exchange names.

cftc_contract_market_code: str | None
CFTC contract market code.

cftc_market_code: str | None
CFTC market code.

cftc_region_code: str | None
CFTC region code.

cftc_commodity_code: str | None
CFTC commodity code.

cftc_contract_market_code_quotes: str | None
CFTC contract market code quotes.

cftc_market_code_quotes: str | None
CFTC market code quotes.

cftc_commodity_code_quotes: str | None
CFTC commodity code quotes.

cftc_subgroup_code: str | None
CFTC subgroup code.

commodity: str | None
Commodity.

commodity_group: str | None
Commodity group name.

commodity_subgroup: str | None
Commodity subgroup name.

futonly_or_combined: str | None
If the report is futures-only or combined.

contract_units: str | None
Contract units.