Spark API

Appearance

API Changelog ​

2025-11-17 - v1.0.48 ​

Introducing Hubs with two endpoints:

2025-11-14 - v1.0.47 ​

Add CSV support for Netbacks endpoint.

2025-11-07 - v1.0.46 ​

Add new endpoints to fetch Intraday. Existing endpoints have been renamed "contracts".

2025-08-18 - v1.0.45 ​

Add new endpoints to fetch Netbacks Arb Breakevens, aligning with the new methodology update.

Note: The Beta endpoint for Netback Arb Breakevens (using the old methodology) is now deprecated. No new data will be added from the December 05, 2025 at 6:30PM UK. We advise our users to use the new v1.0 endpoint to retrieve Spark's latest and most accurate prices.

2025-08-08 - v1.0.44 ​

Updates endpoints URLs:

  • Intraday Live from /beta/intraday/live/ to /beta/intraday/contracts/live/
  • Intraday Historical from /beta/intraday/historical/ to /beta/intraday/contracts/historical/
  • Intraday Revisions from /beta/intraday/revisions/ to /beta/intraday/contracts/revisions/

2025-07-28 - v1.0.43 ​

Removed the concept of scopes for API authentication. Note: Backward compatibility is maintained; existing clients using scopes will continue to function, but their settings will be disregarded. Please update your implementation.

2025-07-18 - v1.0.42 ​

Introduce Intraday.

  • Add new endpoint Live (JKM-TTF only).
  • Add new endpoint Historical (JKM-TTF only).
  • Add new endpoint Revisions (JKM-TTF only).

2025-05-15 - v1.0.41 ​

2025-02-10 - v1.0.40 ​

2024-11-26 - v1.0.39 ​

Add new Access API endpoints to fetch:

All of the new endpoints can return data in either JSON or CSV format.

2024-10-08 - v1.0.38 ​

Update SparkR list endpoint (beta version) limit query parameter: max value constraint limited to 30 items per API call.

2024-08-27 - v1.0.37 ​

Update Routes endpoint with new query parameters: congestion-laden-days and congestion-ballast-days

2024-06-28 - v1.0.36 ​

Update rate limiting values

2024-02-22 - v1.0.35 ​

Add breakdown costs to SparkR endpoints (beta version)

2024-01-04 - v1.0.34 ​

Add SparkR endpoints (beta version)

2023-12-13 - v1.0.33 ​

Add support for Cargo(Basis) half month contracts:

  • sparknwe-b-1h
  • sparknwe-b-2h
  • sparknwe-1h
  • sparknwe-2h

To fetch the contract details:

To fetch the price releases:

2023-12-11 - v1.0.32 ​

  • Add congestion query params to the Netbacks endpoint, allowing congestion simulation at the Panama Canal.

2023-10-20 - v1.0.31 ​

Add $/MMBtu (usdPerMMBtu) prices for LNG FFA contracts:

  • spark25ffa-monthly
  • spark25ffa-yearly
  • spark30ffa-monthly
  • spark30ffa-yearly

For more details, please check:

2023-10-10 - v1.0.30 ​

  • Add a congestion query param to the Routes endpoint, allowing congestion simulation at the Panama Canal.

2023-07-07 - v1.0.29 ​

2023-06-14 - v1.0.28 ​

Fix a bug in the List Price Releases endpoint that caused duplicated price release data for organisations participating in the price release.

2023-05-03 - v1.0.27 ​

Add deliveryPeriod.lastAssessmentDate to new price releases of the following contracts:

  • LNG Freight forwards contracts: spark25fo, spark30fo, spark25ffa-monthly and spark30ffa-monthly
  • All LNG Basis contracts: sparknwe-b-f, sparknwe-f, sparknwe-b-fo, sparknwe-fo , sparkswe-b-f, sparkswe-f, sparkswe-b-fo, sparkswe-fo, sparknwe-fin-monthly, sparknwe-des-fin-monthly, sparkswe-fin-monthly and sparkswe-des-fin-monthly

2023-03-30 - v1.0.26 ​

Add Spark Access (beta version): consolidated pricing and slot information for key European LNG Terminals.

2023-03-28 - v1.0.25 ​

Correct Routes field name costInUsdPerDay by adding a new field costsInUsd. To reduce the impacts, costInUsdPerDay will be supported until further notice, but please consider it has been deprecated and start using the new costsInUsd field.

2023-03-07 - v1.0.24 ​

Add support for Spark LNG DES financial outright contracts:

  • sparknwe-des-fin-monthly
  • sparkswe-des-fin-monthly

To fetch the contract details:

To fetch the price releases:

2022-12-06 - v1.0.23 ​

Add support for Spark LNG DES Basis financial contracts:

  • sparknwe-fin-monthly
  • sparkswe-fin-monthly

To fetch the contract details:

To fetch the price releases:

2022-11-24 - v1.0.22 ​

  • Add contracts for Spark DES LNG:
  • sparknwe-f
  • sparknwe-fo
  • sparkswe-f
  • sparkswe-fo

To fetch the contract details:

To fetch the price releases:

2022-09-13 - v1.0.21 ​

  • Add 174 prices for LNG Freight contracts:

    • spark25s
    • spark25fo
    • spark30s
    • spark30fo
    • spark25ffa-monthly
    • spark25ffa-yearly
    • spark30ffa-monthly
    • spark30ffa-yearly

    To fetch 174 prices, add query parameter ?vessel-type=174-2stroke.

  • Add new field meta in LNG Freight price releases, to describe the vessel type (either 160-tfde or 174-2stroke).

For more details, please check:

2022-08-31 - v1.0.20 ​

  • API returns HTTP 403 (and not HTTP 401 anymore) in case of missing Oauth2 scope(s).

2022-06-30 - v1.0.19 ​

  • Add IP address filtering to block access to non-authorized devices. This is an optional feature. Please get in touch with us for IP whitelisting.

2022-03-16 - v1.0.18 ​

  • Add status (Enum: "active" or "inactive") to "Contract" (impacted endpoints: "Read contracts" and "Read contract")

2022-01-28 - v1.0.17 ​

  • LNG Basis prices are now available (subscription based. Please contact us for access).
  • Deprecation note: Scope read:lng-freight-prices has been replaced by read:prices. More info here.

2021-09-16 - v1.0.16 ​

  • Add routes endpoints.

2021-08-17 - v1.0.15 ​

  • Add webhooks.

2021-07-07 - v1.0.14 ​

  • Backward compatibility: Allow queries on /oauth/token/ without any Content-Type header (in that case, the body will be interpreted as a JSON one).

2021-07-05 - v1.0.13 ​

  • Make the API authentication process fully compliant with the RFC6749. This change is backward-compatible and doesn't require existing implementations to be updated.

2021-07-01 - v1.0.12 ​

  • Add data/aggregatedData/balanceOfMonth to price release responses for LNG Freight FFA monthly contracts (current ticker symbols: spark25ffa-monthly, spark30ffa-monthly).

2021-05-05 - v1.0.11 ​

  • Add pagination support to /price-releases/

2021-04-08 - v1.0.10 ​

  • Subscription plan update: under the basic plan, only limited access to the SparkS prices is available.

2021-03-17 - v1.0.9 ​

  • Add ShipOwner data-points to price release responses (accessible only to premium users).
  • Documentation improvements

2021-01-27 - v1.0.8 ​

Let's say this is the initial version 😃

All rights reserved. © Spark Commodities 2025.