FXMacroData

COT Report

cot_data

Read-only

Get weekly CFTC Commitment of Traders (COT) positioning data for a currency's FX futures contract on the CME, covering speculator positioning, non-commercial longs vs shorts, hedge-fund FX positioning, and sentiment extremes. Returns weekly snapshots with long/short open interest by trader category. Updated every Friday at 15:30 ET reflecting the Tuesday cutoff. USD (the USD Index contract) is available without an API key for the most recent 90 days on a 15-minute release delay; every other currency and the full history need an API key. Supported currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "cot_data"
  }
}

Input Schema

Name	Required	Description
`limit`	No	Rows per page for instrument reads (1-100).
`offset`	No	Row offset for instrument reads.
`report`	No	CFTC report type. Omit for the Legacy futures-only report (commercial / non-commercial / non-reportable). One of: legacy_futures, legacy_combined, tff_futures, tff_combined, disaggregated_futures. TFF reports return dealer, asset manager, leveraged funds and other reportable positions for FX contracts and the dollar index; disaggregated_futures is published for XAU (COMEX gold) only.
`currency`	No	3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU.
`end_date`	No	Inclusive upper bound, YYYY-MM-DD.
`instrument`	No	Any CFTC contract by instrument id (rates, equity, energy, metals and micro contracts) instead of a currency. Use `list` to see the supported instrument/report combinations.
`start_date`	No	Inclusive lower bound, YYYY-MM-DD.

Output Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 9, 2026

changedInput schema / properties / currency / description

Previous value: -"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD, XAU."New value: +"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU."

Changed20 schema fields changedNov 5, 2026
- removedInput schema / properties / currency / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedInput schema / properties / currency / default
```
Removed value: -null
```
- addedInput schema / properties / currency / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedInput schema / properties / end_date / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedInput schema / properties / end_date / default
```
Removed value: -null
```
- changedInput schema / properties / end_date / examples
```
Previous value: -[
-  "2020-01-01",
-  "2024-06-30"
-]New value: +[
+  "2024-06-30"
+]
```
- addedInput schema / properties / end_date / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedInput schema / properties / instrument / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedInput schema / properties / instrument / default
```
Removed value: -null
```
- addedInput schema / properties / instrument / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedInput schema / properties / limit / default
```
Removed value: -null
```
- removedInput schema / properties / offset / default
```
Removed value: -null
```
- removedInput schema / properties / report / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedInput schema / properties / report / default
```
Removed value: -null
```
- addedInput schema / properties / report / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedInput schema / properties / start_date / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedInput schema / properties / start_date / default
```
Removed value: -null
```
- changedInput schema / properties / start_date / examples
```
Previous value: -[
-  "2020-01-01",
-  "2024-06-30"
-]New value: +[
+  "2024-06-30"
+]
```
- addedInput schema / properties / start_date / type
```
Added value: +[
+  "string",
+  "null"
+]
```
- removedInput schema / title
```
Removed value: -"cot_dataArguments"
```

Changed7 schema fields changedOct 31, 2026

addedInput schema / properties / currency / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / currency / default
```
Added value: +null
```
removedInput schema / properties / currency / type
```
Removed value: -"string"
```

addedInput schema / properties / instrument

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Any CFTC contract by instrument id (rates, equity, energy, metals and micro contracts) instead of a currency. Use `list` to see the supported instrument/report combinations.",
+  "examples": [
+    "list",
+    "ust_10y",
+    "wti_crude"
+  ]
+}

addedInput schema / properties / limit

Added value: +{
+  "anyOf": [
+    {
+      "maximum": 100,
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Rows per page for instrument reads (1-100)."
+}

addedInput schema / properties / offset

Added value: +{
+  "anyOf": [
+    {
+      "minimum": 0,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Row offset for instrument reads."
+}

removedInput schema / required
```
Removed value: -[
-  "currency"
-]
```

Changed2 schema fields changedOct 8, 2026

changedInput schema / properties / currency / description

Previous value: -"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU."New value: +"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD, XAU."

addedInput schema / properties / report

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "CFTC report type. Omit for the Legacy futures-only report (commercial / non-commercial / non-reportable). One of: legacy_futures, legacy_combined, tff_futures, tff_combined, disaggregated_futures. TFF reports return dealer, asset manager, leveraged funds and other reportable positions for FX contracts and the dollar index; disaggregated_futures is published for XAU (COMEX gold) only.",
+  "examples": [
+    "tff_futures",
+    "tff_combined",
+    "legacy_combined"
+  ]
+}

Changed3 schema fields changedSep 7, 2026
- removedInput schema / properties / currency / title
```
Removed value: -"Currency"
```
- removedInput schema / properties / end_date / title
```
Removed value: -"End Date"
```
- removedInput schema / properties / start_date / title
```
Removed value: -"Start Date"
```

Changed1 schema field changedAug 27, 2026

changedInput schema / properties / currency / description

Previous value: -"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD, XAU."New value: +"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU."

Changed1 schema field changedJun 28, 2026

changedInput schema / properties / currency / description

Previous value: -"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD."New value: +"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD, XAU."

Changed1 schema field changedMay 27, 2026

changedInput schema / properties / currency / description

Previous value: -"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, NZD, TRY, USD."New value: +"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD."

Changed1 schema field changedMay 25, 2026

changedInput schema / properties / currency / description

Previous value: -"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD."New value: +"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, NZD, TRY, USD."

Changed6 schema fields changedMay 21, 2026

addedInput schema / properties / currency / description

Added value: +"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD."

addedInput schema / properties / currency / examples

Added value: +[
+  "eur",
+  "jpy",
+  "gbp",
+  "aud"
+]

addedInput schema / properties / end_date / description
```
Added value: +"Inclusive upper bound, YYYY-MM-DD."
```

addedInput schema / properties / end_date / examples

Added value: +[
+  "2020-01-01",
+  "2024-06-30"
+]

addedInput schema / properties / start_date / description
```
Added value: +"Inclusive lower bound, YYYY-MM-DD."
```

addedInput schema / properties / start_date / examples

Added value: +[
+  "2020-01-01",
+  "2024-06-30"
+]

First observedApr 15, 2026

TDQS

Score is being calculated.

All FXMacroData tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

COT Report

Tool call template

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources