Current Drydock Stays

Retrieve list of current drydock stays for vessels in different countries or regions.

Example questions that can be answered with this endpoint:

  • Which Capesize vessels are currently in dry dock in China?

class oceanbolt.sdk.data.dry_dock.DryDockCurrentVessels(client: APIClient)[source]

The DryDockCurrentVessels returns list of currently active dry dock stays.

get(**kwargs)[source]

Retrieves currently active dry dock data as a pandas.DataFrame

Example

Which capesize vessels are currently drydocked in China?

from oceanbolt.sdk.client import APIClient
from oceanbolt.sdk.data.dry_dock import DryDockCurrentVessels


base_client = APIClient("<token>")
df = DryDockCurrentVessels(base_client).get(
    country_code=['CN'],
    segment=['capesize']
)

Returns:

imo

vesselName

segment

subSegment

dwt

portId

portName

currentCountryCode

arrivedAt

waitingTimeDays

shipyardId

shipyardName

lat

lng

speed

course

countryName

countryCode

9038438

STELLAR GALAXY

Capesize

VLOC (250k+)

263130

1525

Matsushima

JP

2020-12-03T03:55:00Z

202.26453669499088

9583

Matsushima Shipyard

0

0

0

0

Japan

JP

9044229

STELLAR EAGLE

Capesize

VLOC (250k+)

278258

348

Guangzhou

CN

2021-01-11T08:55:22Z

163.0559487313819

14363

Guangzhou Shipyard 20

0

0

0

0

China

CN

9002673

ATLANTIC MERCHANT

Capesize

Large Capesize (180-250k)

238818

2143

Singapore

SG

2021-01-12T10:23:07Z

161.99501123148215

750

Singapore Keppel Shipyard

0

0

0

0

Singapore

SG

9003122

HBIS SUNRISE

Capesize

VLOC (250k+)

268132

2143

Singapore

SG

2021-04-14T01:22:57Z

70.37012697228242

750

Singapore Keppel Shipyard

0

0

0

0

Singapore

SG

9573775

PACIFIC ENDURANCE

Capesize

Large Capesize (180-250k)

181458

7627

Changtu Island

CN

2021-04-25T01:42:05Z

59.3568399355469

9361

Changtu Island Shipyard

0

0

0

0

China

CN

9844100

Sea Victoria

Capesize

VLOC (250k+)

325000

356

Chiwan

CN

2021-05-16T12:17:52Z

37.915323731644726

5863

Ximazhou Shipyard Island

0

0

0

0

China

CN

9488865

EPIC

Capesize

Large Capesize (180-250k)

180149

359

Dalian

CN

2021-05-24T04:07:36Z

30.255786694479525

5898

Dalian Shipyard

0

0

0

0

China

CN

9588457

STAR POLARIS

Capesize

Capesize (140-180k)

179678

8355

Shanhaiguan

CN

2021-05-27T04:51:02Z

27.225624657491412

9642

SHANHAIGUAN SHIPBUILDING INDUSTRY CO.,LTD(CSIC)

0

0

0

0

China

CN

9589384

JABAL NAFUSA

Capesize

Capesize (140-180k)

169097

403

Kemen Port

CN

2021-05-28T05:49:38Z

26.184930213393255

9253

Kemen Shipyard

0

0

0

0

China

CN

9579781

NEW HYDRA

Capesize

Capesize (140-180k)

179258

8355

Shanhaiguan

CN

2021-05-28T08:50:06Z

26.059606139097607

9642

SHANHAIGUAN SHIPBUILDING INDUSTRY CO.,LTD(CSIC)

0

0

0

0

China

CN

9456680

LAKE DOLPHIN

Capesize

Capesize (140-180k)

179418

442

Shanghai

CN

2021-05-29T09:53:56Z

25.01527743544707

9431

Shanghai Shipyard 3

0

0

0

0

China

CN

Arguments

class oceanbolt.com.drydock_v3.types.GetDryDockRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]

DryDock request object.

port_id

List of Oceanbolt port ids to filter on. This filters on the port where the vessel is currently in dry dock.

Type:

MutableSequence[int]

port_unlocode

List of five letter UNLOCODEs for to filter on.

Type:

MutableSequence[str]

shipyard_id

List of Oceanbolt shipyard ids to filter on. This filters on the shipyard where the vessel is currently in dry dock.

Type:

MutableSequence[int]

country_code

The list of 2-letter ISO countries to get congestion data for. This filters on the country where the vessel is currently congested. Country code can be obtained either from the /entities/countries endpoint.

Type:

MutableSequence[str]

region_id

The list of region IDs to get dry dock data for. Region ID can be obtained either from the /entities/regions endpoint.

Type:

MutableSequence[str]

segment

Cannot be supplied alongside subSegment

Type:

MutableSequence[str]

sub_segment

List of vessel sub segments to filter on. Allowed values can be obtained from the /entities/segments endpoint. Cannot be supplied alongside segment

Type:

MutableSequence[str]

group_by

Determines the grouping of the timeseries data. This parameter only applies to the /drydock/timeseries endpoint.

Type:

str

exclude

60 days will be excluded from the returned data.

Type:

int

format_

The return format of the data [“csv”,”json”, “xlsx”]. Default is “json”.

Type:

str

start_date

The UTC start date of the date filter

Type:

str

end_date

The UTC end date of the date filter

Type:

str

last_n_days

Short hand parameter for quickly getting data for the last N days. Cannot be supplied along either start_date or end_date.

Type:

int

sort

Specifies whether results should be sorted in ascending or descing order. Allowed values: [“asc”,”desc”].

Type:

str

display_date

Parameter used to display historical vessel lists for congested vessels. It is only applicable to the DryDockVessels method.

Type:

str

Response

class oceanbolt.com.drydock_v3.types.DryDockStay(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]
imo

IMO number of the vessel.

Type:

int

vessel_name

Name of the vessel.

Type:

str

segment

The vessel segment (handysize, supramax, panamax etc.).

Type:

str

sub_segment

The vessel sub segment (large capesize, kamsarmax, vloc etc.).

Type:

str

dwt

The DWT of the vessel.

Type:

float

port_id

The Oceanbolt port id where the vessel is currently docked.

Type:

int

port_name

The name of the port where the vessel is currently docked.

Type:

str

shipyard_id

The Oceanbolt shipyard id where the vessel is currently docked.

Type:

int

shipyard_name

The name of the shipyard where the vessel is currently docked.

Type:

str

country_name

The name of the country where the vessel is currently docked.

Type:

str

country_code

The 2-letter ISO code of the country where the vessel is currently docked.

Type:

str

current_country_code

OLD FIELD - WILL BE DEPRECATED!!! (The 2-letter ISO code of the country where the vessel is currently docked.)

Type:

str

arrived_at

The UTC timestamp of when the vessel arrived at the current port.

Type:

str

waiting_time_days

The duration in days that the vessel has been dry docked up until today.

Type:

float

lat

Not implemented.

Type:

google.protobuf.wrappers_pb2.DoubleValue

lng

Not implemented.

Type:

google.protobuf.wrappers_pb2.DoubleValue

course

Not implemented.

Type:

google.protobuf.wrappers_pb2.DoubleValue

speed

Not implemented.

Type:

google.protobuf.wrappers_pb2.DoubleValue