Python - Contract (Cargo Forward)

The API Data Explorer tool is useful for picking elements from the JSON dictionary that the API returns. The endpoint used is the following: /v1.0/contracts/{contract_ticker_symbol}/price-releases/.

{
    "errors": [],
    "data": [
      {
        "id": 20240919,
        "contractId": "sparknwe-fo",
        "releaseDate": "2024-09-19",
        "previousPriceRelease": {
          "id": 20240912,
          "releaseDate": "2024-09-12"
        },
        "nextPriceRelease": null,
        "assessmentWindowClosedAt": "2024-09-19T15:30:00Z",
        "assessmentWindowOpenedAt": "2024-09-19T07:00:00Z",
        "data": [
          {
            "revisionNumber": 0,
            "revisionPublishedAt": "2024-09-19T15:47:55.879511Z",
            "numberOfAssessors": {
              "spark": 5
            },
            "dataPoints": [
              {
                "index": 0,
                "deliveryPeriod": {
                  "type": "month",
                  "startAt": "2024-11-01",
                  "endAt": "2024-11-30",
                  "name": "M+2",
                  "lastAssessmentDate": "2024-09-26"
                },
                "yourAssessedPrice": null,
                "derivedPrices": {
                  "usdPerMMBtu": {
                    "spark": "11.076",
                    "sparkMin": "11.041",
                    "sparkMax": "11.146",
                    "portfolioPlayer": null,
                    "portfolioPlayerMin": null,
                    "portfolioPlayerMax": null,
                    "shipOwner": null,
                    "shipOwnerMin": null,
                    "shipOwnerMax": null
                  }
                },
                "meta": []
              },
              {
                "index": 1,
                "deliveryPeriod": {
                  "type": "month",
                  "startAt": "2024-12-01",
                  "endAt": "2024-12-31",
                  "name": "M+3",
                  "lastAssessmentDate": "2024-10-24"
                },
                "yourAssessedPrice": null,
                "derivedPrices": {
                  "usdPerMMBtu": {
                    "spark": "11.318",
                    "sparkMin": "11.268",
                    "sparkMax": "11.368",
                    "portfolioPlayer": null,
                    "portfolioPlayerMin": null,
                    "portfolioPlayerMax": null,
                    "shipOwner": null,
                    "shipOwnerMin": null,
                    "shipOwnerMax": null
                  }
                },
                "meta": []
              }
              // -----------------------**...**------------------------
            ]
          }
        ]
      }
      // -----------------------**...**------------------------
    ]
  }

Note

----**...**---- denotes repetition of the above dictionary

▲ prices and dates are given for sample purposes only

For simplicity, the JSON dictionary is denoted as response_json.

Indexation

Contract ID:

response_json["data"][0]["contractId"]

Release Date:

response_json["data"][0]["releaseDate"]

Delivery Period Start:

response_json["data"][0]["data"][0]["dataPoints"][0]["deliveryPeriod"]["startAt"]

Delivery Period Name:

response_json["data"][0]["data"][0]["dataPoints"][0]["deliveryPeriod"]["name"]

Price USD/MMBtu M+2:

response_json["data"][0]["data"][0]["dataPoints"][0]["derivedPrices"]["usdPerMMBtu"]["spark"]

Price USD/MMBtu M+3:

response_json["data"][0]["data"][0]["dataPoints"][1]["derivedPrices"]["usdPerMMBtu"]["spark"]

The JSON dictionary is the result of a successful request to the contract API endpoint using the Contract ID as the unique identifier for the Spark NWE Basis Forward Assessment. The Delivery Period Start/End refer to the delivery period of the assessment released on the Release Date. Prices in USD per day denote the Spark NWE Basis Forward assessment for that Release Date: the minimum and maximum of these values are only accessible with a full subscription.