Connect to Spark via multiple methods

To save you time and effort, we’ve built multiple options for you to integrate our data into your systems.

Excel Add-in Excel Add-in

Retrieve Spark prices directly from within your Excel sheet.

More details
Spark API Spark API

Integrate with your systems directly via our API.
Automatically update forward curves, get additional prices for marking positions, bolster risk management systems and use the Spark prices to support analysis. No more manual downloads required and designed for the future.

More details
Spark Webhooks Spark Webhooks

Get the latest price information as they are released automatically via our Webhooks API.
Benefits include getting the latest prices as they are released and receiving an updated price when there’s a price correction.

More details
3rd-Party Connectors

Retrieve our prices via our 3rd-party connectors.
Available to Spark Premium subscribers. 3rd Party Connectors may apply additional costs.

ZEMA™ ZEMA™
Morningstar Morningstar
Enverus Enverus

Frequently Asked Questions

Firstly, you need an account with us. Any existing Spark accounts within your organisation can be used or you can also create a new account set up as a developer (which doesn't count towards number of nominated Spark Premium accounts).
For Premium plan users:
Navigate to “Contract” > “Data integrations” > “Spark API” on the sidebar menu and follow the steps in this page to access our API.

For Basic plan users: Download button Click on the download button and select “Download with our API”. Follow the steps in this page to access our API.

All Spark users have basic access which means that you can access the SparkS price for free but with a limited dataset.

To access the SparkF, SparkFo, historical data and wider data sets, users must have premium access which applies on an organisation level. Please get in touch if you'd like more detailed information.

As our API evolves, we will ensure that the older versions of the endpoints remain available to limit any changes on your side. We'll make sure you have enough time to move to the latest version.
The data available via the API is linked to your organisation. This is to ensure that people changes are easier to manage in the future. Additional users can be added to ensure the right teams and people have access to the information and each organisation has a secure, unique token.
The information available via the API is linked to your permission status. Unlimited access to historical data and full forward curves is only available to those with Premium access. Get in touch to find out more.
Yes, your data is secure. Spark uses a HTTPS over TLS (HyperText Transfer Protocol Secure) as a secured, bidirectional tunnel for communication and OAuth2 as authorization framework.

Rate limiting of the API is primarily on per-customer basis — or more accurately described, per user access token. Following limits are currently the default setting:

  • Throttling (requests per second): 50 req/sec
  • Burst (bucket size): 200
  • Quota (requests per day): 1000 req/day

You can request an increase of these limits. Please contact us directly via contact@sparkcommodities.com and describe your scenario.

Either analysts with previous API experience or your IT teams should be comfortable with this. We've designed our API to make it as quick and easy as possible. We are also always available to help if needed.

Spark Webhooks


Quick links


What is Spark Webhooks?

Webhooks refers to a combination of elements that collectively create a notification and reaction system within a larger integration. Metaphorically, webhooks are like a phone number that Spark calls to notify you of Spark events. The event could be a new price release or a price correction to an existing price release managed by Spark.

When to use webhooks?

Many events that occur within the Spark ecosystem are asynchronous; happening at a later time and not directly in response to your code’s execution. For e.g. a price correction to an existing price release. With these and similar APIs, Spark needs to notify your integration about changes to the status of an object so your integration can take subsequent steps. The specific actions your webhook endpoint may take differs based upon the event. Webhooks can also be used to provide state and API responses to services or systems that use Spark data for actions like alerting.


Getting started

1. Create an endpoint

Create an webhook endpoint on your server. You’ll need the endpoint URL to proceed to the next step.

2. Register

Add your webhook endpoint URL via the Manage your webhooks table and configure the event subscriptions.

3. Build your webhook

See our API documentation for guides on building your webhooks.

You can get the SIGNING_SECRET via the Manage your webhooks table by clicking on the URL to access its details and going to the Signing Secret section of the page.

4. Validate

Trigger Spark events manually and validate the registration of webhook endpoint.

Steps to test your webhooks:

  1. After creating a webhook in the Manage your webhooks table, click on the URL to access its details.
  2. In your webhook details page, go to the Webhook Logs section and click on Send test webhook.
  3. In the modal that appears, select the event type and then click Send test webhook.
  4. The resulting notification and your endpoint’s response are viewable by clicking on the event in the logs below. You may need to wait up to 15 seconds for the logs to reflect on this section.