Get Port Details with Prices

Get detailed information about a specific marine fuel port including current bunker prices.

Endpoint

GET /v1/marine-ports/{port_code}

Authentication

This endpoint requires authentication. Include your API key in the request header:

Authorization: Token YOUR_API_KEY

Path Parameters

Parameter	Type	Description
`port_code`	string	The port code (e.g., SGSIN for Singapore)

Response

{
  "status": "success",
  "data": {
    "port": {
      "code": "SGSIN",
      "name": "Singapore",
      "country": "Singapore",
      "region": "Asia",
      "major_port": true,
      "coordinates": {
        "latitude": 1.2966,
        "longitude": 103.7764
      },
      "metadata": {
        "timezone": "Asia/Singapore",
        "fuel_services": ["MGO_05S", "VLSFO", "HFO_380", "HFO_180"],
        "trading_hours": "24/7",
        "annual_volume_mt": 50000000
      },
      "recent_prices": [
        {
          "fuel_type": "MGO_05S",
          "fuel_name": "Marine Gas Oil 0.5%S",
          "price": 682.50,
          "formatted": "$682.50",
          "currency": "USD",
          "unit": "metric_ton",
          "source": "shipandbunker",
          "timestamp": "2025-08-04T23:40:42.018Z"
        },
        {
          "fuel_type": "VLSFO",
          "fuel_name": "Very Low Sulfur Fuel Oil",
          "price": 517.50,
          "formatted": "$517.50",
          "currency": "USD",
          "unit": "metric_ton",
          "source": "shipandbunker",
          "timestamp": "2025-08-04T23:40:43.104Z"
        },
        {
          "fuel_type": "HFO_380",
          "fuel_name": "Heavy Fuel Oil 380 CST",
          "price": 419.50,
          "formatted": "$419.50",
          "currency": "USD",
          "unit": "metric_ton",
          "source": "shipandbunker",
          "timestamp": "2025-08-04T23:40:44.183Z"
        }
      ],
      "statistics": {
        "total_fuel_types": 4,
        "recent_price_updates": 10,
        "last_update": "2025-08-04T23:40:44Z"
      }
    }
  }
}

Examples

Get Singapore port details

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/marine-ports/SGSIN

Get Rotterdam port details

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/marine-ports/NLRTM

Available Port Codes

Code	Port Name	Region
SGSIN	Singapore	Asia
NLRTM	Rotterdam	Europe
USHOU	Houston	Americas
AEFUJ	Fujairah	Middle East
HKHKG	Hong Kong	Asia
USLAX	Los Angeles	Americas
USNYC	New York	Americas
BRSSZ	Santos	Americas

Response Fields

Port Information

code: Unique port identifier
name: Port name
country: Country location
region: Geographic region
major_port: Boolean for major hub status
coordinates: GPS location
metadata: Additional port details including timezone and annual volume

Price Information

fuel_type: Fuel grade code (MGO_05S, VLSFO, HFO_380, HFO_180)
fuel_name: Human-readable fuel name
price: Current price in USD per metric ton
formatted: Formatted price string
currency: Price currency (USD)
unit: Price unit (metric_ton)
source: Data source
timestamp: Price update time

Statistics

total_fuel_types: Number of fuel types available
recent_price_updates: Count of recent price updates
last_update: Most recent price update timestamp