Skip to main content
Skip table of contents

Canal throughput Service

Suez and Panama Canal throughput

Track throughput over time with the following Python and API query, which monitors vessel counts and aggregate tonnage transiting through the Suez and Panama Canals.

PYTHON QUERIES

Suez Canal throughput

PY
from oceanbolt.sdk.client import APIClient

from oceanbolt.sdk.data.tonnage import ZoneChangesTimeseries

from datetime import date, timedelta

import pandas as pd

import os

#by default, Oceanbolt presents Dry bulk vessels, to view Tanker market data you need to add "tank" in the base_client line.

base_client = APIClient("","tank")

#for aggregate throughput i.e. Northbound plus Southbound Suez Canal transiting vessels

Suez_Canal_transit = ZoneChangesTimeseries(base_client).get(

    start_date=date(2024, 1, 1), #change to start date of interest

    end_date=date(2025, 6, 16), #change to start date of interest

    frequency="daily", #change the grouping as you require

    from_zone_id=[18,35], #zone ID for East Mediterranean 

    to_zone_id=[1], #zone ID for Suez Canal

)

print("Suez Canal transit data ")

print(Suez_Canal_transit)

#For Southbound Travel

Suez_Canal_Southbound = ZoneChangesTimeseries(base_client).get(

    start_date=date(2024, 1, 1), #change to start date of interest

    end_date=date(2025, 6, 16), #change to end date of interest

    frequency="daily", #change the grouping as you require

    from_zone_id=[18], #zone ID for East Med

    to_zone_id=[1], # zone ID for Suez Canal

)

print("Suez Canal Southbound data ")

print(Suez_Canal_Southbound)

#For Northbound Travel

Suez_Canal_Northbound = ZoneChangesTimeseries(base_client).get(

    start_date=date(2024, 1, 1),

    end_date=date(2025, 6, 16),

    frequency="daily",

    from_zone_id=[35], #zone ID for Red Sea

    to_zone_id=[1], #zone ID for Suez Canal

)

print("Suez Canal Northbound data ")

print(Suez_Canal_Northbound)

Panama Canal throughput

PY
from oceanbolt.sdk.client import APIClient

from oceanbolt.sdk.data.tonnage import ZoneChangesTimeseries

from datetime import date, timedelta

import pandas as pd

import os

#By default, Oceanbolt presents Dry bulk vessels. To view Tanker market data, you need to add "tank" in the base_client line.

base_client = APIClient("","tank")

#for aggregate throughput i.e., Northbound plus Southbound Panama Canal transiting vessels

Panama_Canal_throughput= ZoneChangesTimeseries(base_client).get(

    start_date=date(2024, 1, 1), #change to start date of interest

    end_date=date(2025, 6, 16), #change to end date of interest

    frequency="daily", #change the grouping as you require

    from_zone_id=[32,15], #zone ID for Pacific Ocean (Central America) and West Atlantic Ocean (Americas)

    to_zone_id=[4], # zone ID for Panama Canal

)

print("Panama Canal total throughput data ")

print(Panama_Canal_transit)

#For Southbound Travel

Panama_Canal_Southbound = ZoneChangesTimeseries(base_client).get(

    start_date=date(2024, 1, 1), #change to start date of interest

    end_date=date(2025, 6, 16), #change to end date of interest

    frequency="daily", #change the grouping as you require

    from_zone_id=[15], #zone ID West Atlantic Ocean (Americas)

    to_zone_id=[4], #zone ID for Panama Canal

)

print("Panama Canal Southbound data ")

print(Panama_Canal_Southbound)

#For Northbound Travel

Panama_Canal_Northbound = ZoneChangesTimeseries(base_client).get(

    start_date=date(2024, 1, 1), #change to start date of interest

    end_date=date(2025, 6, 16), #change to end date of interest

    frequency="daily", #change the grouping as you require

    from_zone_id=[32], #zone ID for Pacific Ocean (Central America)

    to_zone_id=[4], #zone ID for Panama Canal

)

print("Panama Canal Northbound data ")

print(Panama_Canal_Northbound)

API QUERIES

Suez Canal throughput

API url

https://api.oceanbolt.com/v3/tonnage/zonechanges?startDate=2025-01-01&endDate=2025-06-26&frequency=daily&fromZoneId=18&fromZoneId=35&toZoneId=1

API endpoint

https://api.oceanbolt.com/v3/tonnage/zonechanges

API body

JSON
{

"fromZoneId": [35,18],

"toZoneId": [1],

"startDate": "2025-01-01",

"endDate": "2025-06-26",

"frequency": "daily",

}

Suez Canal Southbound

API url

https://api.oceanbolt.com/v3/tonnage/zonechanges?startDate=2025-01-01&endDate=2025-06-26&frequency=daily&fromZoneId=18&toZoneId=1

API endpoint

https://api.oceanbolt.com/v3/tonnage/zonechanges

API body

JSON
{

"fromZoneId": [18],

"toZoneId": [1],

"startDate": "2025-01-01",

"endDate": "2025-06-26",

"frequency": "daily",

}

Suez Canal Northbound

API url

https://api.oceanbolt.com/v3/tonnage/zonechanges?startDate=2025-01-01&endDate=2025-06-26&frequency=daily&fromZoneId=35&toZoneId=1

API endpoint

https://api.oceanbolt.com/v3/tonnage/zonechanges

API body

JSON
{

"fromZoneId": [35],

"toZoneId": [1],

"startDate": "2025-01-01",

"endDate": "2025-06-26",

"frequency": "daily",

}

Panama Canal throughput

API url

https://api.oceanbolt.com/v3/tonnage/zonechanges?startDate=2025-01-01&endDate=2025-06-26&frequency=daily&fromZoneId=15&fromZoneId=32&toZoneId=4

API endpoint

https://api.oceanbolt.com/v3/tonnage/zonechanges

API body

JSON
{

"fromZoneId": [32,15],

"toZoneId": [4],

"startDate": "2025-01-01",

"endDate": "2025-06-26",

"frequency": "daily",

}

Panama Canal Southbound

API url

https://api.oceanbolt.com/v3/tonnage/zonechanges?startDate=2025-01-01&endDate=2025-06-26&frequency=daily&fromZoneId=15&toZoneId=4

API endpoint

https://api.oceanbolt.com/v3/tonnage/zonechanges

API body

JSON
{

"fromZoneId": [15],

"toZoneId": [4],

"startDate": "2025-01-01",

"endDate": "2025-06-26",

"frequency": "daily",

}

Panama Canal Northbound

API url

https://api.oceanbolt.com/v3/tonnage/zonechanges?startDate=2025-01-01&endDate=2025-06-26&frequency=daily&fromZoneId=32&toZoneId=4

API endpoint

https://api.oceanbolt.com/v3/tonnage/zonechanges

API body

JSON
{

"fromZoneId": [32],

"toZoneId": [1],

"startDate": "2025-01-01",

"endDate": "2025-06-26",

"frequency": "daily",

}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.