The /catalogue endpoint provides structured metadata for all datasets available in the Sparta platform. Each item in the response represents a single curve quotation, offering users a powerful way to discover data relevant to their needs. API Reference: <https://documentation.sparta.app/v2.0/docs/sparta-catalogue>.

📘

Example

GET /catalogue?filter[region]=NWE&filter[quotation]=Margin price by load&filter[vertical]=ULSD&pageSize=1

JSON Response

    "items": [
        {
            "id": "0007f4dd-673a-5309-b606-178aadbd2d2c",
            "name": "RAS LAFFAN - BARCELONA VIACAPE Jet-A1 LR2 - Margin by Load",
            "units": "$/mt",
            "filters": {
                "region": "AG",
                "vessel": "LR2",
                "loadPort": "RAS LAFFAN",
                "vertical": "Jet",
                "productType": "Physical",
                "dischargePort": "BARCELONA",
                "quotation": "Margin by load"
            },
            "properties": {
                "vessel": "LR2",
                "routing": "VIACAPE",
                "specName": "Jet-A1",
                "incoterms": "EXS",
                "routeCode": "LAFBCNVIACAPELR2",
                "loadPortName": "RAS LAFFAN",
                "loadPortRegion": "AG",
                "dischargePortName": "BARCELONA",
                "dischargePortRegion": "MED"
            },
            "contracts": [
                "11-15 Aug 25",
                "11-15 Nov 25",
                "11-15 Jul 25",
                "16-20 Oct 25",
                ...
            ]
        }
    ],
    "self": "https://api.sparta.app/v2/catalogue?page=1&pageSize=1",
    "next": "https://api.sparta.app/v2/catalogue?page=2&pageSize=1",
    "prev": null,
    "last": "https://api.sparta.app/v2/catalogue?page=4221&pageSize=1"
}

🔍 Filtering the catalogue

The curve quotations may include their own custom filters like gradeor loadPort.

There are filters that apply to every curver quotation to refine search results from the beginning:

• vertical
• quotation
• region

Quotations by vertical

Regions by vertical

🗒️ Curve quotation information

📆 Contracts

Each curve quotation lists the contract periods for which data is available. Contracts are represented like: