COT Report

获取交易商持仓报告（COT，Commitment of Traders）：商业与非商业交易商在各板块的多头、空头与价差持仓明细。覆盖软商品、能源、金融等品种，是判断市场情绪与资金动向的经典数据源。

GEThttps://fmp-v2.icu/stable/commitment-of-traders-report

数据更新周期

Weekly

接口说明

接口地址

GET/stable/commitment-of-traders-report

请求需要携带网关下发的 API Key。接口路径及参数名称与 FMP 官方格式保持一致。

请求参数

3 个参数

参数	类型	要求	示例	说明
`symbol`	string	可选	`AAPL`	证券代码，例如 AAPL 或 MSFT。
`from`	date	可选	`2024-01-01`	查询起始日期，格式 YYYY-MM-DD，包含当天。
`to`	date	可选	`2024-03-01`	查询结束日期，格式 YYYY-MM-DD，包含当天。

返回数据

下表列出示例响应中的主要字段，实际字段会因接口及数据状态而有所不同。

字段	类型	说明
`symbol`	string	证券代码
`date`	string	数据对应日期
`name`	string	标的名称
`sector`	string	板块
`marketAndExchangeNames`	string	市场交易所names（marketAndExchangeNames）
`cftcContractMarketCode`	string	CFTCcontract市场code（cftcContractMarketCode）
`cftcMarketCode`	string	CFTC市场code（cftcMarketCode）
`cftcRegionCode`	string	CFTC地区code（cftcRegionCode）
`cftcCommodityCode`	string	CFTC商品code（cftcCommodityCode）
`openInterestAll`	number	开盘利息all（openInterestAll）
`noncommPositionsLongAll`	number	noncomm持仓长期all（noncommPositionsLongAll）
`noncommPositionsShortAll`	number	noncomm持仓短期all（noncommPositionsShortAll）
`noncommPositionsSpreadAll`	number	noncomm持仓spreadall（noncommPositionsSpreadAll）
`commPositionsLongAll`	number	comm持仓长期all（commPositionsLongAll）
`commPositionsShortAll`	number	comm持仓短期all（commPositionsShortAll）
`totReptPositionsLongAll`	number	totrept持仓长期all（totReptPositionsLongAll）

查看响应数据示例

[
{
"symbol": "VX",
"date": "2024-02-27 00:00:00",
"name": "CBOE VIX (VX)",
"sector": "INDICES",
"marketAndExchangeNames": "VIX FUTURES - CBOE FUTURES EXCHANGE",
"cftcContractMarketCode": "1170E1",
"cftcMarketCode": "E",
"cftcRegionCode": "0",
"cftcCommodityCode": "117",
"openInterestAll": 361331,
"noncommPositionsLongAll": 74471,
"noncommPositionsShortAll": 115175,
"noncommPositionsSpreadAll": 97649,
"commPositionsLongAll": 162356,
"commPositionsShortAll": 119436,
"totReptPositionsLongAll": 334476,
"totReptPositionsShortAll": 332260,
"nonreptPositionsLongAll": 26855,
"nonreptPositionsShortAll": 29071,
"openInterestOld": 361331,
"noncommPositionsLongOld": 74471,
"noncommPositionsShortOld": 115175,
"noncommPositionsSpreadOld": 97649,
"commPositionsLongOld": 162356,
"commPositionsShortOld": 119436,
"totReptPositionsLongOld": 334476,

内容已截断，完整字段以实际返回为准。

使用说明

日期、证券代码和枚举参数应严格使用接口要求的格式。
超出分钟限流时会返回 HTTP 429，请根据响应状态合理重试。
空数组通常表示当前查询条件下暂无数据，不代表请求失败。

需要稳定访问 COT Report 数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 3 天