Python - Contract (Cargo Financial)

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": 20240923,
      "contractId": "sparknwe-des-fin-monthly",
      "releaseDate": "2024-09-23",
      "previousPriceRelease": {
        "id": 20240920,
        "releaseDate": "2024-09-20"
      },
      "nextPriceRelease": null,
      "assessmentWindowClosedAt": "2024-09-23T16:00:00Z",
      "assessmentWindowOpenedAt": "2024-09-23T14:30:00Z",
      "data": [
        {
          "revisionNumber": 0,
          "revisionPublishedAt": "2024-09-23T16:02:35.854690Z",
          "numberOfAssessors": {
            "spark": 3
          },
          "dataPoints": [
            {
              "index": 0,
              "deliveryPeriod": {
                "type": "month",
                "startAt": "2024-10-01",
                "endAt": "2024-10-31",
                "name": "M+1",
                "lastAssessmentDate": "2024-09-26"
              },
              "yourAssessedPrice": null,
              "derivedPrices": {
                "usdPerMMBtu": {
                  "spark": "11.60600",
                  "sparkMin": "11.60100",
                  "sparkMax": "11.60600",
                  "portfolioPlayer": null,
                  "portfolioPlayerMin": null,
                  "portfolioPlayerMax": null,
                  "shipOwner": null,
                  "shipOwnerMin": null,
                  "shipOwnerMax": null
                }
              },
              "meta": []
            },
            {
              "index": 1,
              "deliveryPeriod": {
                "type": "month",
                "startAt": "2024-11-01",
                "endAt": "2024-11-30",
                "name": "M+2",
                "lastAssessmentDate": "2024-10-29"
              },
              "yourAssessedPrice": null,
              "derivedPrices": {
                "usdPerMMBtu": {
                  "spark": "11.84200",
                  "sparkMin": "11.84200",
                  "sparkMax": "11.84700",
                  "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+1:

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

Price USD/MMBtu M+2:

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 Financial 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 Financial assessment for that Release Date: the minimum and maximum of these values are only accessible with a full subscription.