The Historical endpoints serve data for a specific window as defined by a start and end date (UTC).

Sparta provides two ways to access historical market data, depending on your desired level of granularity:

End-of-Day Snapshots – one value per day, captured at 16:30 London time.
Timeseries – aka 'Intraday', high-frequency values with 1-15 minute granularity.

End-of-Day Snapshots

One snapshot per day, captured at 16:30 London time (or 12:30 on early close days).
Requests require a start and end date.

By EOD we refer to the price taken at the London settlement time.
It is not an exchange settlement price.

You can use this data to:

Plot historical forward curves for a given arbitrage (ARB)
Compare forward pricing across different years
Track historical movement of underlying components (e.g., FOB prices, freight, structure)

📘
Downloading large datasets?
For bulk exports across multiple months or verticals, use the Bulk Download API to download data as Parquet files — significantly faster than paginating through individual settlements.

📘

Example

GET /historical/settlements/0007f4dd-673a-5309-b606-178aadbd2d2c/11-15 Jun 25?startDate=2025-05-09&endDate=2025-05-16

[
    {
        "date": "2025-05-16",
        "value": {
            "generatedOn": "2025-05-16T15:16:05.173",
            "price": 3.5788883413888546,
            "units": "$/mt",
            "tenor": "11-15 Jun 25",
            "dependencies": [
                {
                    "id": "dd758b98-0227-5e68-8529-b35307373d27",
                    "name": "RAS LAFFAN - BARCELONA VIACAPE Jet-A1 LR2 - Dlvd Price by Load",
                    "value": -0.5788883413888545,
                    "units": "$/mt",
                    "tenorName": "11-15 Jun 25"
                },
                {
                    "id": "cdc954af-529e-5f98-8a2e-c3543a2cbe81",
                    "name": "RAS LAFFAN - BARCELONA VIACAPE Jet-A1 LR2 - Sales Price",
                    "value": 3.0,
                    "units": "$/mt",
                    "tenorName": "21-25 Jul 25"
                }
            ],
            "metadata": [
              // ...
            ]
        }
    },
    {
        "date": "2025-05-15",
        "value": {
            "generatedOn": "2025-05-15T15:16:05.76",
            "price": 2.4695080882743485,
            "units": "$/mt",
            "tenor": "11-15 Jun 25",
            "dependencies": [
                {
                    "id": "dd758b98-0227-5e68-8529-b35307373d27",
                    "name": "RAS LAFFAN - BARCELONA VIACAPE Jet-A1 LR2 - Dlvd Price by Load",
                    "value": 2.5304919117256515,
                    "units": "$/mt",
                    "tenorName": "11-15 Jun 25"
                },
                {
                    "id": "cdc954af-529e-5f98-8a2e-c3543a2cbe81",
                    "name": "RAS LAFFAN - BARCELONA VIACAPE Jet-A1 LR2 - Sales Price",
                    "value": 5.0,
                    "units": "$/mt",
                    "tenorName": "21-25 Jul 25"
                }
            ],
            "metadata": [
              // ...
            ]
        }
    },
  // ...
]

Timeseries

Also referred to as 'intraday', it provides historical data with 1 to 15 minute granularity, making it the most detailed dataset available.

You can query over a custom time range by specifying a start and end date.

Maximum date range is 30 days. For larger ranges, use monthly iterations (e.g. 30-day windows).
The bulk download endpoint only serves snapshot level historical data. A tick-level historical dataset will be very large for long periods. If you are interested in such a dataset, please reach out to Sparta Customer Support to inquire about ways to obtain this dataset.

Use this data to:

Analyse short-term price volatility
Investigate intraday market movements
Study underlying components like premiums, cash diffs, and blend components in fine detail

📘

Example

GET /historical/intraday/0007f4dd-673a-5309-b606-178aadbd2d2c/11-15 Jun 25

{
    "items": [
        {
            "generatedOn": "2025-05-19T11:46:04.619",
            "price": 5.587244205568989,
            "units": "$/mt",
            "tenor": "11-15 Jun 25",
            "dependencies": [
                {
                    "id": "dd758b98-0227-5e68-8529-b35307373d27",
                    "name": "RAS LAFFAN - BARCELONA VIACAPE Jet-A1 LR2 - Dlvd Price by Load",
                    "value": -2.587244205568988,
                    "units": "$/mt",
                    "tenorName": "11-15 Jun 25"
                },
                {
                    "id": "cdc954af-529e-5f98-8a2e-c3543a2cbe81",
                    "name": "RAS LAFFAN - BARCELONA VIACAPE Jet-A1 LR2 - Sales Price",
                    "value": 3.0,
                    "units": "$/mt",
                    "tenorName": "21-25 Jul 25"
                }
            ],
            "metadata": [
                { "name": "loadDate", "value": "2025-06-15T00:00:00.000Z" },
                { "name": "deliveryDate", "value": "2025-07-25T00:00:00.000Z" }
                // ...
            ]
        }
        // Additional intraday items...
    ],
    "self": "https://api.sparta.app/v2/ongoing/intraday/0007f4dd-673a-5309-b606-178aadbd2d2c/11-15%20Jun%2025?&page=1&pageSize=100",
    "next": null,
    "prev": null,
    "last": "https://api.sparta.app/v2/ongoing/intraday/0007f4dd-673a-5309-b606-178aadbd2d2c/11-15%20Jun%2025?&page=1&pageSize=100"
}

Historical Data

End-of-Day Snapshots

Example

Timeseries

Example

What’s Next