[Datasets](https://gloom.sh/datasets#datasets) Macro and positioning

# CFTC positioning.

One futures contract report, with open interest and positions by trader class. Every response carries its sources and dates.

- [See plans](https://gloom.sh/datasets/pricing)
- [Read the reference](https://gloom.sh/datasets/docs/datasets/cot)

Request 1 credit

```
curl "https://api.gloom.sh/v1/cot?report=legacy" \
  -H "Authorization: Bearer $GLOOM_DATASETS_KEY"
```

With your key, this call returns the latest data. The response is one record of the [free sample](https://api.gloom.sh/v1/datasets/cot/sample), which needs no key.

Response · data[0]

```
{
  "contractCode": "067651",
  "marketName": "WTI-PHYSICAL - NEW YORK MERCANTILE EXCHANGE",
  "reportDate": "2026-10-13",
  "openInterest": 1900179,
  "position": {
    "long": 344653,
    "short": 244310,
    "spreading": 546758,
    "id": "noncommercial",
    "label": "Noncommercial",
    "net": 100343,
    "netPercentOfOpenInterest": 5.28071302756,
    "weeklyChange": 1283,
    "previousReportDate": "2026-10-06",
    "percentile1Y": {
      "value": 40.5660377358,
      "rank": 21.5,
      "sampleCount": 53,
      "windowStart": "2025-10-13",
      "windowEnd": "2026-10-13",
      "historyStart": "2025-10-14",
      "historyEnd": "2026-10-13",
      "completeWindow": true,
      "min": 39800,
      "max": 233620,
      "mean": 120643.849057
    },
    "percentile3Y": {
      "value": 15.6050955414,
      "rank": 24.5,
      "sampleCount": 157,
      "windowStart": "2023-10-13",
      "windowEnd": "2026-10-13",
      "historyStart": "2023-10-17",
      "historyEnd": "2026-10-13",
      "completeWindow": true,
      "min": 39800,
      "max": 306388,
      "mean": 174029.783439
    }
  }
}
```

Trimmed real output

## Who uses it.

- ### Quant teams

  Track positioning by trader class.
- ### Research agents

  Explain who is long and who is short.

## Coverage and price.

- **routes**: 2
- **source**: 1
- **credit for the cheapest call**: 1

In all 44 datasets on every plan, from $200/mo. [See plans](https://gloom.sh/datasets/pricing)

**Routes and credits (2)**

- `GET /v1/cot` CFTC positioning by contract 1 credit
- `GET /v1/cot/{contractCode}` CFTC contract positioning history 2 credits

## Related.

- [EIA energy inventories](https://gloom.sh/datasets/energy-inventories)
- [FINRA short volume](https://gloom.sh/datasets/short-volume)
- [US consumer prices](https://gloom.sh/datasets/cpi)