Curve Structure

Curve structure endpoints summarize contango/backwardation and prompt-spread behavior.

Endpoints

MethodEndpointDescription
GET/v1/spreads/curve-structureCurrent curve structure snapshot
GET/v1/spreads/curve-structure/allAll available curve structure series

No Historical Path

There is no /v1/spreads/curve-structure/historical endpoint in the current live surface.

Example

The selector is commodity, not code. Valid values: ICE_BRENT, ICE_WTI, ICE_GASOIL, NYMEX_NG, ICE_TTF. Omitting it returns 400 MISSING_PARAMETER.

curl "https://api.oilpriceapi.com/v1/spreads/curve-structure?commodity=ICE_BRENT" \
  -H "Authorization: Token YOUR_API_KEY"

{
  "status": "success",
  "data": {
    "commodity": "ICE_BRENT",
    "display_name": "ICE Brent Crude",
    "structure": "backwardation",
    "severity": "extreme",
    "term_slope_pct": -38.7,
    "spreads": { "m1_m3": 9.09, "m1_m6": 16.82, "m1_m12": 25.26 },
    "front_month": { "price": 104.32, "contract": "Nov 2026" },
    "back_month_6": { "price": 87.5, "contract": "Apr 2027" },
    "curve_points": 16,
    "timestamp": "2026-09-13T15:11:37Z"
  }
}

See Spreads & Margins for common parameters, response shape, and error handling.

Last Updated: