list_markets
List COT markets
Lists the CFTC markets COT-Reports covers (350+): CFTC code, ticker, name, exchange, category and which report families exist for each. Filter by a search text, a category or a report family. Available at every level.
Parameterslimitreportsearchcategory
get_latest_snapshot
Latest COT snapshot of every market
The latest Legacy COT report of every market, 100 markets per answer (use offset for the next page): net positions of large speculators and commercials, their week-on-week change, and open interest. Filter by category. Available at every level. Both CFTC variants (Futures Only and Futures & Options Combined) with COT Premium and Data API keys; without an account and with a free account, each report's default variant.
Parametersoffsetvariantcategory
get_latest_positions
Latest COT positions for one market
The latest COT report for one market: long, short and net positions of every trader group, the week-on-week change, % of open interest. Without an account and with a free account: the Legacy report. COT Premium and Data API keys: every report family (Legacy, Disaggregated, TFF, Supplemental); COT Premium also adds the close price. Both CFTC variants (Futures Only and Futures & Options Combined) with COT Premium and Data API keys; without an account and with a free account, each report's default variant.
Parametersmarketrequiredreportvariant
get_history
COT history for one market
Weekly COT history for one market, newest first: open interest and the net position of every trader group (up to 260 reports per call; page back with "until"). Without an account: Legacy, the last 26 reports (6 months). Free account: Legacy, the last 520 reports (10 years). COT Premium and Data API keys: every report family and the full history; COT Premium also adds close prices. A new COT Premium subscription that can still be withdrawn from reads the last year of what Premium adds, until the date in its confirmation e-mail. Both CFTC variants (Futures Only and Futures & Options Combined) with COT Premium and Data API keys; without an account and with a free account, each report's default variant.
Parametersfromuntilmarketrequiredreportreportsvariant
get_cot_index
COT index for one market
The COT index (0–100: where the current net position sits between its lowest and highest of the lookback window) for large speculators and commercials, from the Legacy report. Without an account: the 26- and 52-week windows; a free account, COT Premium and a Data API key: every window. Both CFTC variants (Futures Only and Futures & Options Combined) with COT Premium and Data API keys; without an account and with a free account, each report's default variant.
Parametersmarketrequiredvariantlookback_weeks
scan_extremes
Markets at positioning extremes
Markets where large speculators are crowded long or short this week (the Crowding score: a blend of the 26-, 52- and 156-week percentiles of their net position as % of open interest; crowded long from 80 until it falls below 75, crowded short from 20 until it rises above 25), from the Legacy Futures Only report. COT Premium only, as on the website.
Parametersside
get_weekly_summary
COT weekly summary
The weekly summary of the 35 main markets (currencies, crypto, metals, energy, agriculture, stock indices) from the latest Legacy report: net positions of speculators and commercials and their change. Available at every level. Both CFTC variants (Futures Only and Futures & Options Combined) with COT Premium and Data API keys; without an account and with a free account, each report's default variant.
Parametersvariant
get_release_schedule
COT release schedule
Which COT report is the latest, when it was published, and when the next one is due (the CFTC publishes on Fridays at 3:30 pm Eastern for the Tuesday before; holidays move it). Available at every level.
Takes no parameters.
explain_cot
Explain a COT concept
A short explanation of a COT concept — the trader groups, net positions, open interest, the four report families, the COT index, release timing — with a link to the full guide. Available at every level.
Parameterstopicrequired