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

Daily Settlements – one value per day, taken at London market close.
Intraday – high-frequency values with 15-minute granularity.

Daily settlements

One value per day, taken at a consistent snapshot time: 16:30 London time (or 12:30 on early close days). A time range must be specified.

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)

📘

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": [
              // ...
            ]
        }
    },
  // ...
]

Intraday

It provides historical data with 15-minute granularity, making it the most detailed dataset available. You can query over a custom time range by specifying a star and end date.

Use this data to:

Analyze 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"
}