---
title: "Commitments of Traders positioning"
method: GET
path: "/v1/cot/"
tags: ["Analytics"]
---

# Commitments of Traders positioning

`GET /v1/cot/`

## Request

- Base URL: `https://api.metalcharts.org`
- URL: `https://api.metalcharts.org/v1/cot/`
- Auth: none declared

COT (Commitments of Traders) positioning history for a metal. Requires the Pro plan or higher.

## Query parameters

- `type` string
- `metal` string, required: Required. XAU, XAG, HG, XPT or XPD.
- `range` string: One of 1M, 3M, YTD, 1Y, 5Y, 10Y or ALL. Defaults to 1Y. ALL returns the whole series, and MAX is accepted as a synonym for it.

## Response `200`

Success.

- object
  - `success` boolean, required
  - `metal` string
  - `range` string
  - `count` number
  - `data` object[], required
    - `cftcContractCode` string
    - `marketName` string
    - `metal` string
    - `mmLong` number
    - `mmNet` number
    - `mmShort` number
    - `mmSpreading` number
    - `nrLong` number
    - `nrNet` number
    - `nrShort` number
    - `openInterest` number
    - `orLong` number
    - `orNet` number
    - `orShort` number
    - `orSpreading` number
    - `pmLong` number
    - `pmNet` number
    - `pmShort` number
    - `reportDate` string, date
    - `sdLong` number
    - `sdNet` number
    - `sdShort` number
    - `sdSpreading` number
  - `timestamp` string, date-time

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/metalcharts/apis/metalcharts-api.md) · [All operations](https://skmtc.dev/metalcharts/apis/metalcharts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metalcharts/apis/metalcharts-api/revisions/53d6a0af0479?raw)