LNG Freight Contracts

Freight Subscription Required

Contact us to discuss our Premium plans at commercial@sparkcommodities.com.

Looking to pull our historical Freight data?

Visit our Python Code Examples section to download our contracts or FFAs code sample, the quickest way to start pulling Freight data.

The Contracts API endpoints are at the core of the Spark API: it provides price data for all the contracts that Spark prices, notably Freight spot assessments or forward curves.

Freight contracts are released at the following times:

Contract	Price Release	Ticker
Spark30S / Spark25S	10:00 GMT Daily	spark30s / spark25s
Spark30Fo / Spark25Fo	10:00 GMT Tuesday	spark30fo / spark25fo
Spark30FFA / Spark25FFA	16:30 UKT Daily	spark30ffa-monthly / spark25ffa-monthly, spark30ffa-yearly / spark25ffa-yearly

Note on Price Releases

Prices may take longer to update. Please expect up to 1 hour after the Price Release to find the most updated release.

Below is a typical step-by-step process of accessing specific contract datasets.

Code Sample 🚀

For a step-by-step Python (Jupyter Notebook) example of accessing and formatting the Spark API historical price data, please visit our Github page.

List Contracts

/v1.0/contracts/

By calling the base contracts endpoint, the API output is the contracts that are currently available to call based on your subscription, including Freight and/or Cargo contracts. This outputs as a JSON data file, listing for each contract:

• Contract Name (e.g. Spark30 FFA)
• Contract Type (e.g. FFA- monthly)
• Assessment Frequency
• Assessment Dates/Times
• Assumptions used in the contract (e.g. vessel size)
• Previous, Latest and Next Price Release Dates for chosen contract

Please read our Methodology and Specifications guide for more details about contract and submission assumptions.

See API Reference

Get Contract

/v1.0/contracts/{contract_ticker_symbol}/

Retrieve details on the contract:

• Contract Name (e.g. Spark30 FFA)
• Contract Type (e.g. FFA- monthly)
• Assessment Frequency
• Assessment Dates/Times
• Assumptions used in the contract (e.g. vessel size)
• Previous, Latest and Next Price Release Dates for chosen contract

This step is not mandatory to fetch the data, but can just be used to retrieve added information about the chosen contract. Please read our Methodology and Specifications guide for more details about contract and submission assumptions.

See API Reference

Get Latest Price Release

/v1.0/contracts/{contract_ticker_symbol}/price-releases/latest/

Now that the contract’s chosen, the latest price release data for the chosen contract can be retrieved using this URL endpoint.

The JSON output includes:

• Spark Assessed price of the chosen contract
• Assessment/release date of the assessed price(s)
• Date of Previous and Next price release

If you are a premium user, the JSON output will also include:

• Range associated with the assessed price (Max and Min values)
• Tenor of the contract

More contextual information around the price is provided, but can’t be summarised here as this can be dependent on contract type (e.g. for Freight prices, prices are listed in $/day and $/MMBtu).

Parameters

Optional parameters can be used to specify conditions on the contract. There is one optional parameters that can be used here:

• vessel-type
  • Freight only
  • Choose which vessel type the retrieved contract price uses in it’s base assumptions.
  • Two options can be chosen: 160-tfde or 174-2stroke.
  • This parameter can be left undefined, at which point the default vessel type will be used. For more information on vessel types used in price assessments, please refer to the Methodology on the Freight platform.

Price Release Frequency

Spark Commodities releases prices several times per week, which is called a Price Release. Please read our Methodology and Specifications guide for more details. You can also refer to the nextPriceRelease key to know when the next release will occur.

Non Authenticated Requests

This endpoint is accessible for non-authenticated requests, but it returns only outdated spot contracts data (Price Release N-4).

You should subscribe to our API if you would like to fetch the most recent data. Please contact sales@sparkcommodities.com to enquire about it.

Data Revision Policy

Spark will on occasion publish corrections to price assessments after the publication date. These errors may arise from clerical mistakes or miscalculation errors amongst other reasons. Any changes or revisions will take place within two working days following the closing of the submission window. Spark will send a notification of any changes to its previous assessments via email to all users with an explanation as to why a correction was implemented.

See API Reference

List Price Releases

/v1.0/contracts/{contract_ticker_symbol}/price-releases/

Retrieving historical data for a given contract is a more general case use of the Price Releases endpoint. The JSON output contains a list of dictionaries. Each item in this list is structured identically to the JSON described in the section above (Latest Price Releases), and each one represents a historical price release. Put simply, it’s a list of price release JSONs for each release date.

Unlimited access to historical data and full forward curves is only available to those with a premium subscription. Get in touch to find out more.

Parameters

This endpoint has three optional parameters. These are:

• vessel-type
  • Freight only
  • Choose which vessel type the retrieved contract price uses in it’s base assumptions.
  • Two options can be chosen: 160-tfde or 174-2stroke.
  • This parameter can be left undefined, at which point the default vessel type will be used. For more information on vessel types used in price assessments, please refer to the Methodology on the Freight platform.
• offset
  • Optional integer value to set from where to start returning data.
  • E.g. offset=2 provides all historical prices, from 2 days before current release onwards.
  • Default is 0.
• limit
  • Optional integer value to set an upper limit on the number of price releases returned by the endpoint.
  • E.g. limit=10 gives you the last 10 price releases for the chosen contract
  • Default is 200.

See API Reference

Get First Price Release

/v1.0/contracts/{contract_ticker_symbol}/price-releases/first/

Retrieves the first price release data for the chosen contract. This is another use of historical data, so it would also require a Premium subscription.

The behavior and data structure is the same as above.

See API Reference

Need to see an example output?

Checkout our API Data Explorer Tool to get an overview of the API format and to quickly select important elements of the output.