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
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
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
API endpoint
https://api.oceanbolt.com/v3/tonnage/zonechanges
API body
{
"fromZoneId": [35,18],
"toZoneId": [1],
"startDate": "2025-01-01",
"endDate": "2025-06-26",
"frequency": "daily",
}
Suez Canal Southbound
API url
API endpoint
https://api.oceanbolt.com/v3/tonnage/zonechanges
API body
{
"fromZoneId": [18],
"toZoneId": [1],
"startDate": "2025-01-01",
"endDate": "2025-06-26",
"frequency": "daily",
}
Suez Canal Northbound
API url
API endpoint
https://api.oceanbolt.com/v3/tonnage/zonechanges
API body
{
"fromZoneId": [35],
"toZoneId": [1],
"startDate": "2025-01-01",
"endDate": "2025-06-26",
"frequency": "daily",
}
Panama Canal throughput
API url
API endpoint
https://api.oceanbolt.com/v3/tonnage/zonechanges
API body
{
"fromZoneId": [32,15],
"toZoneId": [4],
"startDate": "2025-01-01",
"endDate": "2025-06-26",
"frequency": "daily",
}
Panama Canal Southbound
API url
API endpoint
https://api.oceanbolt.com/v3/tonnage/zonechanges
API body
{
"fromZoneId": [15],
"toZoneId": [4],
"startDate": "2025-01-01",
"endDate": "2025-06-26",
"frequency": "daily",
}
Panama Canal Northbound
API url
API endpoint
https://api.oceanbolt.com/v3/tonnage/zonechanges
API body
{
"fromZoneId": [32],
"toZoneId": [1],
"startDate": "2025-01-01",
"endDate": "2025-06-26",
"frequency": "daily",
}