Ship & Bunker Integration
API Access for Your Data

Quick Start Code Example

Once configured, access your Ship & Bunker data like any other OilPriceAPI endpoint:

from oilpriceapi import OilPriceAPI

# Initialize with your BYOS-enabled API key
client = OilPriceAPI("your_api_key")

# Fetch Ship & Bunker prices for Singapore
singapore_prices = client.marine_fuel.get_port_prices(
    port="singapore",
    source="shipandbunker"  # Specify BYOS source
)

# Access structured data
print(f"MGO: {singapore_prices.mgo.price} USD/MT")
print(f"VLSFO: {singapore_prices.vlsfo.price} USD/MT")
print(f"Updated: {singapore_prices.timestamp}")

# Fetch multiple ports at once
ports = client.marine_fuel.get_bulk_prices(
    ports=["singapore", "rotterdam", "fujairah"],
    source="shipandbunker"
)

for port in ports:
    print(f"{port.name}: MGO {port.mgo.price} USD/MT")