Commodities

Get the data sources and methodology table

Changed on

One row per catalogue code with its source label, instrument type, update frequency, publication cadence, nominal stale threshold, source timezone, front-month roll rule and revision policy (spec T3).

Generated from the same catalogue, source-cadence registry, freshness and futures-contract code the API serves from, so it cannot drift from API behaviour. A fact the metadata does not hold reads "not recorded"; it is never estimated. Source labels name government publishers and render market_reporting for every other source. OilPriceAPI grants no rights in any data.

Takes the same listing parameters as GET /v1/commodities. Keyless and cached for an hour.

get/v1/meta/methodology

Request

  • Base URL
    https://api.oilpriceapi.com
  • Auth
    none required

Query parameters

include_unavailableboolean

Also list codes that are not backed by data.

include_discontinuedboolean

Also list discontinued codes.

Response

Methodology rows and their coverage

statusstring

Example response

{
  "status": "success",
  "data": {
    "codes": [
      {
        "code": "WTI_USD",
        "source": {
          "labels": [
            "market_reporting"
          ],
          "roles": [
            "market_data"
          ]
        },
        "instrument_type": "front_month_futures",
        "update_frequency": "realtime",
        "publication_cadence": [
          "intraday"
        ],
        "stale_threshold": {
          "expected_max_age_seconds": 86400,
          "stale_after_seconds": 172800
        },
        "timezone": "not recorded",
        "roll_rule": "not applicable",
        "revision_policy": "not recorded"
      }
    ],
    "coverage": {
      "codes": 900,
      "source_type_cadence_complete": 6
    }
  },
  "meta": {
    "timestamps_timezone": "UTC",
    "not_recorded_value": "not recorded"
  }
}

Changes