Python - Contract (Freight Spot)

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":20240730,
            "contractId":"spark30s",
		    "releaseDate":"2024-07-29",
		    "previousPriceRelease":{
                "id":20240729,
                "releaseDate":"2024-07-28"
            },
		    "nextPriceRelease":{
                "id":20240731,
                "releaseDate":"2024-07-30"
			},
            "assessmentWindowClosedAt":"2024-07-29T10:00:00Z",
            "assessmentWindowOpenedAt":"2024-07-29T08:00:00Z",
            "data":[
                {
                    "revisionNumber":0,
                    "revisionPublishedAt":"2024-07-30T10:09:19.310218Z",
                    "numberOfAssessors": null,
                    "dataPoints":[
                        {
                            "index":0,
                            "deliveryPeriod":{
                                "type":"days",
                                "startAt":"2024-08-13",
                                "endAt":"2024-09-12",
                                "name":"SparkS",
                                "lastAssessmentDate": null
                            },
                            "yourAssessedPrice": null,
                            "derivedPrices":{
                                "usdPerDay":{
                                    "spark": "79000", 
                                    "sparkMin": "76000", 
                                    "sparkMax": "80000", 
                                    "portfolioPlayer": null, 
                                    "portfolioPlayerMin": null, 
                                    "portfolioPlayerMax": null, 
                                    "shipOwner": null, 
                                    "shipOwnerMin": null, 
                                    "shipOwnerMax": null
                                },
                                "usdPerMMBtu":{
                                    "spark": "0.8", 
                                    "sparkMin": "0.77", 
                                    "sparkMax": "0.95", 
                                    "portfolioPlayer": null, 
                                    "portfolioPlayerMin": null, 
                                    "portfolioPlayerMax": null, 
                                    "shipOwner": null, 
                                    "shipOwnerMin": null, 
                                    "shipOwnerMax": null
                                }
                            },
                        "meta":[
                            {"type": "freight-vessel-type",
                            "value": "174-2stroke"
                            }
                            ]
                        }
                    ],
                "aggregatedData": null
                    }
                    // -----------**...**-------------
                ],
            "publishedAt":"2024-07-29T10:08:57.666800Z",
            "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"]["dataPoints"][0]["deliveryPeriod"]["startAt"]

Price USD/day:

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

Price USD/MMBtu:

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

Vessel Type:

response_json["data"][0]["data"]["dataPoints"][0]["meta"][0]["value"]

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 Spark30 Spot Atlantic assessment. The Delivery Period Start/End refer to the delivery period of the assessment released on the Release Date. Assumptions made for the calculation are specified in the “meta” key within the JSON dictionary, it includes the type of assumptions and the details of these assumptions. Prices in USD or in USD per MMBtu denote the Spark30 Spot assessment for that Release Date: the minimum and maximum of these values are only accessible with a full subscription.