COT Visual Artifact
cot_visual_artifactRead-only
Returns weekly CFTC COT positioning data with MCP Apps chart metadata. By default it charts noncommercial net positioning; the metric parameter selects another COT field. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metric | No | Field to plot from each COT row. Typical values: noncommercial_net, noncommercial_net_zscore, noncommercial_long, noncommercial_short, open_interest. | noncommercial_net |
| report | No | CFTC report type; omit for the Legacy futures-only report. One of: legacy_futures, legacy_combined, tff_futures, tff_combined, disaggregated_futures. With a TFF report, plot a TFF metric such as leveraged_funds_net or asset_manager_net. | |
| currency | Yes | 3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD, XAU. | |
| end_date | No | Inclusive upper bound, YYYY-MM-DD. | |
| start_date | No | Inclusive lower bound, YYYY-MM-DD. |