Skip to content

Python - Access Costs

The API Data Explorer tool is useful for picking elements from the JSON dictionary that the API returns. The endpoint used is the following: /beta/sparkr/releases/.

jsonc
{
  "errors": [],
  "data": [
    {
      "releaseDate": "2024-08-12",
      "terminalCode": "adriatic",
      "terminalName": "Adriatic",
      "perVesselSize": {
        "160000": {
          "deliveryMonths": [
            {
              "month": "2024-09-01",
              "costsInUsdPerMmbtu": {
                "total": "8",
                "breakdown": {
                  "basic-slot-berth": {
                    "type": "basic-slot-berth",
                    "value": "0.06",
                    "description": "Slot (Berth)"
                  },
                  "basic-slot-unload-storage-regas": {
                    "type": "basic-slot-unload-storage-regas",
                    "value": "5",
                    "description": "Slot (Unload, Storage, Regas)"
                  },
                  "basic-slot-berth-unload-storage-regas": {
                    "type": "basic-slot-berth-unload-storage-regas",
                    "value": "0.0",
                    "description": "Slot (Berth, Unload, Storage, Regas)"
                  },
                  "additional-storage": {
                    "type": "additional-storage",
                    "value": "0.0",
                    "description": "Additional Storage"
                  },
                  "additional-send-out": {
                    "type": "additional-send-out",
                    "value": "0.03",
                    "description": "Additional Send Out"
                  },
                  "fuel-gas-losses-gas-in-kind": {
                    "type": "fuel-gas-losses-gas-in-kind",
                    "value": "0.088",
                    "description": "Fuel Gas Losses (Gas in Kind)"
                  },
                  "entry-capacity": {
                    "type": "entry-capacity",
                    "value": "0.1",
                    "description": "Entry Capacity"
                  },
                  "commodity-charge": {
                    "type": "commodity-charge",
                    "value": "0.0",
                    "description": "Commodity Charge"
                  }
                }
              },
              "costsInEurPerMwh": {
                "total": "4.5",
                "breakdown": {
                  "basic-slot-berth": {
                    "type": "basic-slot-berth",
                    "value": "2",
                    "description": "Slot (Berth)"
                  },
                  "basic-slot-unload-storage-regas": {
                    "type": "basic-slot-unload-storage-regas",
                    "value": "9",
                    "description": "Slot (Unload, Storage, Regas)"
                  },
                  "basic-slot-berth-unload-storage-regas": {
                    "type": "basic-slot-berth-unload-storage-regas",
                    "value": "0.0",
                    "description": "Slot (Berth, Unload, Storage, Regas)"
                  },
                  "additional-storage": {
                    "type": "additional-storage",
                    "value": "0.0",
                    "description": "Additional Storage"
                  },
                  "additional-send-out": {
                    "type": "additional-send-out",
                    "value": "0.89",
                    "description": "Additional Send Out"
                  },
                  "fuel-gas-losses-gas-in-kind": {
                    "type": "fuel-gas-losses-gas-in-kind",
                    "value": "0.4",
                    "description": "Fuel Gas Losses (Gas in Kind)"
                  },
                  "entry-capacity": {
                    "type": "entry-capacity",
                    "value": "3",
                    "description": "Entry Capacity"
                  },
                  "commodity-charge": {
                    "type": "commodity-charge",
                    "value": "0.0",
                    "description": "Commodity Charge"
                  }
                }
              }
            }
            // ----------------**...**---------------
          ],
          "assumptions": {
            "vesselSizeCbm": 160000,
            "dischargeVolumeMmbtu": 3492366
          }
        },
        "174000": {
        // --------------------**...**-------------------
          "assumptions": {
            "vesselSizeCbm": 174000,
            "dischargeVolumeMmbtu": 3814333
          }
        }
      }
    }
   // -----------------------**...**------------------------
  ]
}

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

Release Date:

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

Terminal Code:

response_json["data"][0]["terminalCode"]

Delivery Month (174 2-Stroke Vessel):

response_json["data"][0]["perVesselSize"]["174000"]["deliveryMonths"][0]["month"]

Total Cost (174 2-Stroke Vessel) USD/MMBtu:

response_json["data"][0]["perVesselSize"]["174000"]["deliveryMonths"][0]["costsInUsdPerMmbtu"]["total"]

Total Cost (174 2-Stroke Vessel) Eur/MWh:

response_json["data"][0]["perVesselSize"]["174000"]["deliveryMonths"][0]["costsInEurPerMwh"]["total"]

Slot (Berth) Cost (174 2-Stroke Vessel) USD/MMBtu:

response_json["data"][0]["perVesselSize"]["174000"]["deliveryMonths"][0]["costsInUsdPerMmbtu"]["breakdown"]["basic-slot-berth"]["value"]

Commodity Charge (174 2-Stroke Vessel) USD/MMBtu:

response_json["data"][0]["perVesselSize"]["174000"]["deliveryMonths"][0]["costsInUsdPerMmbtu"]["breakdown"]["commodity-charge"]["value"]

Discharge Volume (174 2-Stroke Vessel):

response_json["data"][0]["perVesselSize"]["174000"]["assumptions"][0]["dischargeVolumeMmbtu"]

The JSON dictionary is the result of a successful request to the Access API endpoint. The dictionary contains the associated costs and assumptions for 160 TFDE vessels and/or 174 2-stroke vessels for each LNG Terminal available, for each Delivery Month. Costs can be returned in either USD/MMBtu or in Eur/Mwh, for a given month, vessel size and terminal.