Basis Spreads

Basis spreads compare a local or regional price against a benchmark.

Endpoints

Method	Endpoint	Description
GET	`/v1/spreads/basis`	Current basis spread snapshot
GET	`/v1/spreads/basis/historical`	Historical basis spread values
GET	`/v1/spreads/basis/all`	All available basis spread series

Example

The selector is pair, not code. Valid values: WAHA_HH, BRENT_WTI, BRENT_DUBAI, TTF_HH, BRENT_OMAN. Omitting it returns 400 MISSING_PARAMETER.

curl "https://api.oilpriceapi.com/v1/spreads/basis?pair=BRENT_WTI" \
  -H "Authorization: Token YOUR_API_KEY"

{
  "status": "success",
  "data": {
    "pair": "BRENT_WTI",
    "spread_name": "Brent-WTI Spread",
    "value": 4.33,
    "unit": "USD/bbl",
    "components": { "BRENT_CRUDE_USD": 104.32, "WTI_USD": 99.99 },
    "signal": "normal",
    "timestamp": "2026-09-13T14:31:46Z",
    "percentile_1y": 49
  }
}

/v1/spreads/basis/all takes no pair and returns every series at once.

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