---
title: "CFTC Commitments of Traders, latest report for every market"
method: GET
path: "/api/markets/cot"
tags: ["Macro"]
---

# CFTC Commitments of Traders, latest report for every market

`GET /api/markets/cot`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/cot`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Docs: https://xoomar.com/markets/api/cot

## Response `200`

OK

- object
  - `data` object[]
    - `slug` string: Market slug for URLs (euro-fx, gold...)
    - `name` string: CFTC contract market name
    - `group` string: currencies, indices, crypto, metals, energy, bonds, agriculture, other
    - `reportType` string: tff (financial futures) or disagg (commodities)
    - `sortRank` number: Display order within the group
    - `reportDate` string, date: CFTC report Tuesday, YYYY-MM-DD
    - `openInterest` number, nullable: Total open interest in contracts
    - `dealerLong` number, nullable: Dealers and intermediaries (tff); producers, merchants, processors and users (disagg)
    - `dealerShort` number, nullable: Dealers and intermediaries (tff); producers, merchants, processors and users (disagg)
    - `assetMgrLong` number, nullable: Asset managers and institutional investors (tff); swap dealers (disagg)
    - `assetMgrShort` number, nullable: Asset managers and institutional investors (tff); swap dealers (disagg)
    - `levFundLong` number, nullable: Leveraged funds (tff); managed money (disagg)
    - `levFundShort` number, nullable: Leveraged funds (tff); managed money (disagg)
    - `otherLong` number, nullable: Other reportable positions
    - `otherShort` number, nullable: Other reportable positions
    - `nonreptLong` number, nullable: Non-reportable (small trader) positions
    - `nonreptShort` number, nullable: Non-reportable (small trader) positions
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)