---
title: "Changes to Get CFTC positioning history"
method: GET
path: "/v1/indicators/cftc-positioning/historical"
---

# Changes to Get CFTC positioning history

`GET /v1/indicators/cftc-positioning/historical`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 17 revisions.

- **2026-10-11** `84bf31be62ff`: 1 breaking, 2 warning, 9 info
- **2026-08-25** `0e79e21dee2e`: 5 info

## Changes

- **2026-10-11** `84bf31be62ff`: 1 breaking, 2 warning, 9 info
  - the `data/period` response's property type changed from `string` to `object` for status `200`
  - deleted the `query` request parameter `period`
  - removed the optional property `data/data/items/value` from the response with the `200` status
  - added the new optional `query` request parameter `commodity`
  - added the new optional `query` request parameter `end_date`
  - added the new optional `query` request parameter `start_date`
  - added the optional property `data/coverage` to the response with the `200` status
  - added the optional property `data/data/items/open_interest` to the response with the `200` status
  - added the optional property `data/data/items/spec_net` to the response with the `200` status
  - added the optional property `data/data/items/spec_net_pct_oi` to the response with the `200` status
  - added the optional property `data/period/end` to the response with the `200` status
  - added the optional property `data/period/start` to the response with the `200` status
- **2026-08-25** `0e79e21dee2e`: 5 info
  - added the new optional `query` request parameter `period`
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `401`
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`

---

[Operation](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/docs/v1/indicators/cftc-positioning/historical/get.md) - [API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [Page](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/changes/v1/indicators/cftc-positioning/historical/get)