chokepoint_volume

Daily transit calls and estimates of transit trade volumes for shipping lane chokepoints around the world.

Examples

from openbb import obb
obb.economy.shipping.chokepoint_volume(provider='imf')
obb.economy.shipping.chokepoint_volume(provider='imf', chokepoint=suez_canal,panama_canal)

Parameters

• standard
• imf

start_date: date | str
Start date of the data, in YYYY-MM-DD format.

end_date: date | str
End date of the data, in YYYY-MM-DD format.

start_date: date | str
Start date of the data, in YYYY-MM-DD format.

end_date: date | str
End date of the data, in YYYY-MM-DD format.

chokepoint: str | list[str]

Description

Name of the chokepoint. Use None for all chokepoints. Choices are:

• suez_canal
  
• panama_canal
  
• bosporus_strait
  
• bab_el_mandeb_strait
  
• malacca_strait
  
• strait_of_hormuz
  
• cape_of_good_hope
  
• gibraltar_strait
  
• dover_strait
  
• oresund_strait
  
• taiwan_strait
  
• korea_strait
  
• tsugaru_strait
  
• luzon_strait
  
• lombok_strait
  
• ombai_strait
  
• bohai_strait
  
• torres_strait
  
• sunda_strait
  
• makassar_strait
  
• magellan_strait
  
• yucatan_channel
  
• windward_passage
  
• mona_passage Multiple items allowed for provider(s): imf.
  

---

Returns

results: list[MaritimeChokePointVolume]

Serializable results.

provider: Optional[Literal['imf']]

Provider name.

warnings: Optional[list[Warning_]]

list of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• imf

date: date | str
The date of the data.

date: date | str
The date of the data.

chokepoint: str
Name of the chokepoint.

vessels_total: int
Number of all ships transiting through the chokepoint on that date. The total is calculated over the sum of vessels_container, vessels_dry_bulk, vessels_general_cargo, vessels_roro and vessels_tanker.

vessels_cargo: int
Total number of ships (excluding tankers) transiting through the chokepoint at this date. This is the sum of vessels_container, vessels_dry_bulk, vessels_general_cargo and vessels_roro.

vessels_tanker: int
Number of tankers transiting through the chokepoint on that date.

vessels_container: int
Number of containers transiting through the chokepoint on that date.

vessels_general_cargo: int
Number of general cargo ships transiting through the chokepoint on that date.

vessels_dry_bulk: int
Yearly average number of dry bulk carriers transiting through the chokepoint. Estimated using AIS data beginning 2019.

vessels_roro: int
Yearly average number of Ro-Ro ships transiting through the chokepoint. Estimated using AIS data beginning 2019.

capacity_total: float
Total trade volume (in metric tons) of all ships transiting through the chokepoint at this date. This is the sum of capacity_container, capacity_dry_bulk, capacity_general_cargo, capacity_roro and capacity_tanker.

capacity_cargo: float
Total trade volume (in metric tons) of all ships (excluding tankers) transiting through the chokepoint at this date. This is the sum of capacity_container, capacity_dry_bulk, capacity_general_cargo and capacity_roro.

capacity_tanker: float
Total trade volume (in metric tons) of tankers transiting through the chokepoint at this date.

capacity_container: float
Total trade volume (in metric tons) of containers transiting through the chokepoint at this date.

capacity_general_cargo: float
Total trade volume (in metric tons) of general cargo Vessels transiting through the chokepoint at this date.

capacity_dry_bulk: float
Total trade volume (in metric tons) of dry bulk carriers transiting through the chokepoint at this date.

capacity_roro: float
Total trade volume (in metric tons) of Ro-Ro ships transiting through the chokepoint at this date.