COT Report ListCOT 报告清单
该接口返回平台支持查询 CFTC 交易者持仓承诺（COT）报告的全部期货与期权品种代码目录。完整列出能源、贵金属、工业金属、农产品、软商品、外汇、利率国债及股指等各大类期货合约的标准代码与品种短名称，是调用 COT 报告与分析接口的前置枚举字典。
https://quote-fmp.com/stable/commitment-of-traders-list数据更新周期
Weekly
接口说明
- COT 期货合约标准代码前置词表：CFTC 期货品种代码具有特定的缩写规则（如原油、黄金、标普指数期货、主要货币对等各自对应特定字母代码）。在调用 COT 原始报告或日期分析接口前，先通过该目录接口拉取全量合法品种代码与名称映射，可确保查询参数准确无误。
- 全球宏观期货跨资产类别全景盘点：返回结果直接为每个期货代码标注了清晰的英文品种全称与资产属性。量化团队可据此将数百个受支持的合约按“股指、国债利率、外汇汇率、能源化工、贵金属、农产品”六大板块归类，构建全天候跨资产监控大盘。
- 自动化周度 COT 采集流水线调度入口：CFTC 每周五美东时间下午定期发布最新持仓数据。工程团队可在周六凌晨先拉取该品种清单作为遍历队列，驱动定时脚本批量同步全品种最新一周的持仓明细与多空情绪分析结果。
- 配套投研接口：Forex Quote（外汇实时报价） · Economics Indicators（经济指标数据） · Commodities List（大宗商品清单） · Commodities Quote（大宗商品报价）
调用代码示例
Python 关键代码/stable/commitment-of-traders-list 专供COT 报告清单查询（仅 apikey），返回列表含 name（名称）、symbol（证券代码）（如 name=Natural Gas (NG)）。
resp = requests.get(
"https://quote-fmp.com/stable/commitment-of-traders-list",
params={"apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 COT 报告清单 核心列：symbol, name
df = df[["symbol", "name"]].dropna(how="all")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量COT 报告清单初始化本地主表 | GET /stable/commitment-of-traders-list（免参数） | 直接请求 /stable/commitment-of-traders-list 即返回全表，含 name、symbol 等 2 列；建库或每日全量覆盖时无需拼接任何 Query 参数。 |
| 以 symbol 为唯一键覆盖写入，避免全表重复 | GET /stable/commitment-of-traders-list → upsert on symbol | 全表每轮返回 symbol（样本 NG）等 2 列，落库时以 symbol 作唯一键覆盖；同模块无参数相近的接口，单点补数只能重拉全表。 |
| 落库后自检：symbol 唯一性与 name 空值率 | GET /stable/commitment-of-traders-list → count(distinct symbol) / null_ratio(name) | 2 列落库完成后，用 count(distinct symbol) 对账行数；name（如 Natural Gas (NG)）若大面积为空，说明本次全表拉取不完整，需要重跑。 |
/stable/commitment-of-traders-list 提供COT 报告清单的 name（名称）等共 2 列；遇到冷门代码或未收录条件返回空数组时应做跳过容错。
针对 /stable/commitment-of-traders-list 输出的 name（Natural Gas (NG)），建表时请用 (symbol, name) 作主键约束，切勿将含前导零或符号的编码列强转为整数。
返回数据
2 个字段本接口示例响应共包含 2 个字段（数值型 0 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "NG" | 证券代码 |
name | string | "Natural Gas (NG)" | 名称 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "NG",
"name": "Natural Gas (NG)"
}
]常见问题解答（FAQ）
2 个问题对比COT 报告清单与 COT 持仓报告：/stable/commitment-of-traders-list 的调用方式和返回字段有哪些独特之处？
COT 报告清单（/stable/commitment-of-traders-list，免业务参数）聚焦于提供 name、symbol 等 2 个字段；同属「Commitment Of Traders」的 COT Report（COT 持仓报告）则提供 128 个字段。
对接COT 报告清单端点 /stable/commitment-of-traders-list 时，大跨度回溯与日常增量刷新分别怎么传参？
对接 COT 报告清单 时可免过滤参数访问 /stable/commitment-of-traders-list 一次性导出完整截面；配合连接池复用与 15～30 秒超时设置，能大幅提升 name 的同步吞吐率。
同模块相关接口对比
Commitment Of Traders本接口路径 /stable/commitment-of-traders-list，无必填参数。 同一模块「Commitment Of Traders」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。