OIoilpriceapi
Spreads

Get futures curve structure

Changed on

Front-relative calendar-month tenors (methodology front_relative_tenor_v2). Legacy m1_m3/m1_m6/m1_m12 keys now mean front minus the price 3/6/12 months after the selected front, not the third/sixth/twelfth available contract. Missing target contracts are linearly interpolated between bracketing observations; no extrapolation. A missing six-month span yields null back_month_6, term_slope_pct and severity, structure unavailable, and a recovery explanation. Each unavailable spread remains present as null. Interpolated back_month_6 has contract null, method linear_interpolation and source_contracts; exact targets have method observed_contract. Seasonal gas slopes are explicitly unadjusted and carry a caveat. This changes derived analysis only; raw futures curve ordering is unchanged.

get/v1/spreads/curve-structure

Request

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

Query parameters

commodity'ICE_BRENT' | 'ICE_WTI' | 'ICE_GASOIL' | 'NYMEX_NG' | 'ICE_TTF' required
Example:ICE_BRENT

Futures curve. The 400 response enumerates valid values.

Response

Get futures curve structure

statusstring required

Example response

{
  "status": "success",
  "data": {
    "methodology": "front_relative_tenor_v2",
    "spread_tenors_months": {
      "m1_m3": 3,
      "m1_m6": 6,
      "m1_m12": 12
    }
  }
}

Changes

  • 7f8b4d763210Revision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the / response's property type changed from array to integer for 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

    • info

      added the optional property / to the response with the status

  • 0e79e21dee2eRevision changes
    • breaking

      added the new required query request parameter commodity

    • 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