OIoilpriceapi
Spreads

Get crack spread history

Changed on

Historical crack spread series.

get/v1/spreads/crack/historical

Request

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

Query parameters

type'jet' | 'diesel' | 'gasoline' | '3-2-1'
Example:jet

Spread type.

crude'BRENT_CRUDE_USD' | 'WTI_USD' | 'BRENT_SPOT_USD' | 'WTI_SPOT_USD'
Example:BRENT_CRUDE_USD

Crude benchmark code.

start_datestring date
Example:2026-09-01

Start of the window (YYYY-MM-DD). Defaults to 30 days ago; capped to the maximum historical range.

end_datestring date
Example:2026-09-30

End of the window (YYYY-MM-DD). Defaults to today.

Response

Get crack spread history

statusstring required

Example response

{
  "status": "success",
  "data": {
    "period": "30d"
  }
}

Changes

  • d83e7b18c195Revision changes
    • warning

      deleted the query request parameter period

    • info

      added the new optional query request parameter crude

    • info

      added the new optional query request parameter end_date

    • info

      added the new optional query request parameter start_date

    • info

      added the new optional query request parameter type

  • 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