OIoilpriceapi
Indicators

Get CFTC positioning history

Changed on

CFTC Legacy Futures Only history grouped by source observation date, excluding rows without observed_at. Each row has date, spec_net, open_interest and spec_net_pct_oi. Requested period is retained and coverage exposes the effective 730-day range and range_limited flag. This endpoint does not provide managed-money futures-and-options history.

get/v1/indicators/cftc-positioning/historical

Request

  • Base URL
    https://api.oilpriceapi.com
  • Auth
    API key in header Authorization

Query parameters

commodity'WTI' | 'BRENT' | 'NATURAL_GAS' | 'HEATING_OIL' | 'GASOLINE'
Example:WTI

Energy contract family; defaults to WTI. BRENT is NYMEX Brent Last Day.

start_datestring date
Example:2026-09-01

Source observation date; defaults to 90 days ago, capped at 730 days.

end_datestring date
Example:2026-10-02

Last source observation date; defaults to today.

Response

Get CFTC positioning history

statusstring required

Example response

{
  "status": "success"
}

Changes

  • 84bf31be62ffRevision changes
    • breaking

      the / response's property type changed from string to object for status

    • warning

      deleted the query request parameter period

    • warning

      removed the optional property /// from the response with the status

    • info

      added the new optional query request parameter commodity

    • info

      added the new optional query request parameter end_date

    • info

      added the new optional query request parameter start_date

    • info

      added the optional property / to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 0e79e21dee2eRevision changes
    • info

      added the new optional query request parameter period

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status