OilPriceAPI Documentation

# 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}
1

# Authentication

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

Authorization: Token YOUR_API_KEY
1

# 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"
      }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# Examples

# Get Singapore port details

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

# Get Rotterdam port details

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

# 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

←