Python - Netbacks

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/netbacks/?fob-port={fob port uuid}&release-date={}&via-point={}/.

{
  "errors": [],
  "data": {
    "name": "Sabine Pass",
    "releaseDate": "2023-10-12",
    "viaPoint": "cogh",
    "congestionLadenDays": 0,
    "congestionBallastDays": 0,
    "netbacks": [
      {
        "monthIdx": 1,
        "load": {
          "month": "2023-11",
          "loadingDate": "2023-11-15"
        },
        "neaCargoDeliveryDate": "2023-12-29",
        "nweCargoDeliveryDate": "2023-12-02",
        "nea": {
          "outright": {
            "usdPerMMBtu": "13.1"
          },
          "ttfBasis": {
            "usdPerMMBtu": "-3.1"
          }
        },
        "nwe": {
          "outright": {
            "usdPerMMBtu": "14.1"
          },
          "ttfBasis": {
            "usdPerMMBtu": "-2.1"
          }
        },
        "max": {
          "outright": {
            "usdPerMMBtu": "14.1"
          },
          "ttfBasis": {
            "usdPerMMBtu": "-2.1"
          }
        },
        "neaMinusNwe": {
          "outright": {
            "usdPerMMBtu": "-1.1"
          },
          "ttfBasis": {
            "usdPerMMBtu": "-1.1"
          }
        },
        "neaMeta": {
          "ttfPrice": {
            "usdPerMMBtu": "17.1"
          },
          "ttfBasis": {
            "usdPerMMBtu": "0.1"
          },
          "desLngPrice": {
            "usdPerMMBtu": "17.1"
          },
          "routeCost": {
            "usdPerMMBtu": "4.1"
          },
          "volumeAdjustment": null,
          "netbackOutright": {
            "usdPerMMBtu": "13.1"
          },
          "netbackTtfBasis": {
            "usdPerMMBtu": "-3.1"
          }
        },
        "nweMeta": {
          "ttfPrice": {
            "usdPerMMBtu": "16.1"
          },
          "ttfBasis": {
            "usdPerMMBtu": "-0.1"
          },
          "desLngPrice": {
            "usdPerMMBtu": "16.1"
          },
          "routeCost": {
            "usdPerMMBtu": "1.1"
          },
          "volumeAdjustment": null,
          "netbackOutright": {
            "usdPerMMBtu": "14.1"
          },
          "netbackTtfBasis": {
            "usdPerMMBtu": "-2.1"
          }
        }
      }
 // -----------**...**-------------
    ],
    "neaAssumptions": {
      "fobPort": {
        "uuid": "c20695bb-306b-4ce5-a8f3-ef5d3769ea7a",
        "name": "Sabine Pass"
      },
      "dischargePort": {
        "name": "Futtsu"
      },
      "viaPoint": "cogh",
      "nauticalMiles": "15855",
      "vesselSizeM3": 174000,
      "vesselSpeedKnots": 17,
      "daysUntilDelivery": 44
    },
    "nweAssumptions": {
      "fobPort": {
        "uuid": "c20695bb-306b-4ce5-a8f3-ef5d3769ea7a",
        "name": "Sabine Pass"
      },
      "dischargePort": {
        "name": "Gate"
      },
      "viaPoint": null,
      "nauticalMiles": "4975",
      "vesselSizeM3": 174000,
      "vesselSpeedKnots": 17,
      "daysUntilDelivery": 17
    }
  }
}

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

Name:

response_json["data"]["name"]

Via Point:

response_json["data"]["viaPoint"]

NEA Discharge Port:

response_json["data"]["neaAssumptions"]["dischargePort"]["name"]

NWE Discharge Port:

response_json["data"]["nweAssumptions"]["dischargePort"]["name"]

Release Date:

response_json["data"]["releaseDate"]

Loading Date:

response_json["data"]["netbacks"][0]["load"]["loadingDate"]

NEA Delivery Date:

response_json["data"]["netbacks"][0]["neaCargoDeliveryDate"]

NWE Delivery Date:

response_json["data"]["netbacks"][0]["nweCargoDeliveryDate"]

NEA Outright USD/MMBtu:

response_json["data"]["netbacks"][0]["nea"]["outright"]["usdPerMMBtu"]

NWE TTF Basis USD/MMBtu:

response_json["data"]["netbacks"][0]["nwe"]["ttfBasis"]["usdPerMMBtu"]

NEA-NWE Difference Outright USD/MMBtu:

response_json["data"]["netbacks"][0]["neaMinusNwe"]["outright"]["usdPerMMBtu"]

The JSON dictionary is the result of a successful request to the Netbacks API endpoint using the FOB Port UUID as the unique identifier for the Sabine Pass via COGH Netbacks, for the 12th of December 2023. The NEA Discharge Port and NWE Discharge Port denote the voyage assumptions used for calculating the Netbacks for the specific Loading Date. The NEA and NWE prices, as well as their difference, can be returned as an Outright or TTF-Basis price in USD per MMBtu.