Tonnage Supply Vessels

Note

available on platforms : Platform.Liquids, Platform.LNG, Platform.LPG, Platform.Dry

class kpler.sdk.resources.tonnage_supply_vessels.TonnageSupplyVessels(configuration, column_ids=True, log_level=None)

The TonnageSupplyVessels provides lists of individual vessels which can arrive at a queried destination zone within a specified timeframe assuming a specified speed.

get(destination, eta, speed, start_date, end_date, products=None, vessel_states=None, vessel_types=None, gte=None, lte=None, columns=None, match_next_port_call=None, vessels=None, build_year=None, build_year_min=None, build_year_max=None, is_open=None)

Parameters

• destination – str Destination name used for Vessel Matcher algorithm

• eta – int ETA in days used for Vessel Matcher algorithm

• speed – int Speed in knots used for Vessel Matcher algorithm

• start_date – date Start of the period (YYYY-MM-DD)

• end_date – date End of the period (YYYY-MM-DD). Cannot exceed start_date by more than 6 days

• products – Optional[List[str]] Names of products eg: crude/co, gasoil

• vessel_states – Optional[List[Enum]] TonnageSupplyVesselsState

• vessel_types – Optional[List[Enum]] TonnageSupplyVesselTypes

• gte – Optional[int] Get vessels with deadweight/capacity greater or equals to this value by default 0

• lte – Optional[int] Get vessels with deadweight/capacity lower or equals to this value by default 606550

• columns – Optional[List[str]] List of column names to return. Use “all” to retrieve all available columns

• match_next_port_call – Optional[bool] Filter to vessels for which the zone of the next port call matches the destination

• vessels – Optional[List[str]] Names or IMOs of the vessels

• build_year – Optional[int] Filter for vessels built in a specific year (exact match). Cannot be used together with build_year_min or build_year_max

• build_year_min – Optional[int] Filter for vessels built from this year onwards (inclusive). Use with build_year_max to define a range

• build_year_max – Optional[int] Filter for vessels built up to this year (inclusive). Use with build_year_min to define a range

• is_open – Optional[bool] Filter to vessels marked as open

Examples

>>> from datetime import date
... from kpler.sdk.resources.tonnage_supply_vessels import TonnageSupplyVessels
... from kpler.sdk import TonnageSupplyVesselTypes
... tonnage_supply_vessels_client=TonnageSupplyVessels(config)
... tonnage_supply_vessels_client.get(
...     destination="Houston",
...     eta=7,
...     speed=11,
...     start_date=date(2025,11,1),
...     end_date=date(2025,11,7),
...     vessel_types=[TonnageSupplyVesselTypes.VLCC],
...     build_year_min=2010
... )

Date (timestamp)	IMO	Name	Dead Weight Tonnage	Vessel Type	Vessel State	Last Product on board	Current Continent
2025-11-01	9816323	Almi Atlas	315221	VLCC	Ballast	Crude/Co	Americas
2025-11-01	9597240	Eagle Vancouver	320299	VLCC	Ballast	Crude/Co	Americas
2025-11-01	9595216	Boston	299996	VLCC	Ballast	Crude/Co	Americas
2025-11-01	9733947	Dht Jaguar	299629	VLCC	Ballast	Crude/Co	Americas
2025-11-01	9537769	South Loyalty	323182	VLCC	Ballast	Crude/Co	Americas
…	…	…	…	…	…	…	…

get_columns()

This endpoint returns a recent and updated list of all columns available for the endpoint tonnage-supply.

Examples

>>> from kpler.sdk.resources.tonnage_supply_vessels import TonnageSupplyVessels
... tonnage_supply_vessels_client=TonnageSupplyVessels(config)
... tonnage_supply_vessels_client.get_columns()

id	name	description	deprecated	type
date	Date (timestamp)		False	date yyyy-MM-dd
vessel_imo	IMO	IMO of the vessel	False	long
vessel	Name	Name of the vessel	False	string
vessel_dwt_tons	Dead Weight Tonnage	Dead Weight Tonnage	False	long
vessel_type	Vessel Type	Type of the vessel	False	string
…	…	…	…	…

Return type

DataFrame

class kpler.sdk.TonnageSupplyVesselTypes(value)

Vessel types for Tonnage Supply endpoints (cross-platform)

AframaxLR2 = 'Aframax/LR2'

BabyCapes = 'Baby Capes'

Capesize = 'Capesize'

Handy = 'Handy'

HandyMR1 = 'Handy/MR1'

Handymax = 'Handymax'

Handysize = 'Handysize'

IntermediateTankers = 'Intermediate Tankers'

Kamsarmax = 'Kamsarmax'

LGC = 'LGC'

LargeScaleFloater = 'Large-Scale Floater'

LowerConventional = 'Lower Conventional'

MGC = 'MGC'

MR = 'MR'

MidConventional = 'Mid Conventional'

MidScale = 'Mid-Scale'

MiniBulker = 'Mini Bulker'

Newcastlemax = 'Newcastlemax'

Panamax = 'Panamax'

PanamaxLR1 = 'Panamax/LR1'

PostPanamax = 'Post-Panamax'

QFlex = 'Q-Flex'

QMax = 'Q-Max'

SGC = 'SGC'

ShortSeaTankers = 'Short Sea Tankers'

SmallScale = 'Small-Scale'

SmallTankers = 'Small Tankers'

SuezmaxLR3 = 'Suezmax/LR3'

Supramax = 'Supramax'

Ultramax = 'Ultramax'

UpperConventional = 'Upper Conventional'

VLAC = 'VLAC'

VLCC = 'VLCC'

VLEC = 'VLEC'

VLGC = 'VLGC'

VLOC = 'VLOC'

Valemax = 'Valemax'

class kpler.sdk.TonnageSupplyVesselsState(value)

Vessel states for Tonnage Supply endpoints

Ballast = 'Ballast'

Loaded = 'Loaded'

Maintenance = 'Maintenance'

Other = 'Other'