DatasetsMacro and positioning

CFTC positioning.

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

See plansRead the reference
Request1 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, 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

Routes and credits2
  • GET /v1/cotCFTC positioning by contract1 credit
  • GET /v1/cot/{contractCode}CFTC contract positioning history2 credits

Related.