OilPriceAPI Docs
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
    • Batch Prices
    • Excel Latest Price Gateway
    • Price Widget Endpoints
    • Price Utility Endpoints
    • Natural Gas Intelligence
  • Commodities

    • List Commodities
    • Get Commodity Details
  • AI Agents (MCP)

    • Get Market Brief
    • Subscriptions / Watches
    • Agent Subscriptions with MCP
  • Marine Fuels

    • Marine Fuel API
    • List Marine Fuel Ports
    • Get Port Details with Prices
    • Bunker Fuels
    • Maritime Fuels
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API
    • Benchmark Close
    • Aviation Fuel Pilot
  • Spreads & Margins

    • Spreads & Margins
    • Crack Spreads
    • Basis Spreads
    • Refining Margins
    • Curve Structure
    • Physical Premiums
  • Market Indicators

    • Market Indicators
    • Fuel Switching
    • Price Context
    • Storage Analytics
    • CFTC Positioning
    • Congressional Trades
    • Market Annotations
  • Futures

    • Futures API
    • ICE Brent Futures
    • ICE WTI Futures
    • ICE Gas Oil Futures
    • NYMEX Natural Gas Futures
    • ICE EUA Carbon Futures
    • EU Carbon Futures
    • TTF Gas Futures
    • LNG JKM Futures
    • UK Carbon Futures
  • Dark Data (Premium)

    • Energy Intelligence API
    • Rig Counts
    • Well Permits
    • Well Production Beta
    • Oil Inventories
    • OPEC Production
    • Drilling Productivity
    • Forecasts (STEO)
  • Well Production (Beta)

    • Well Production Data
    • Well Production API Reference
  • Analytics

    • Analytics API
  • Webhooks API

    • Webhooks API Reference
    • Webhook Endpoint Reference
  • Alerts

    • Price Alerts API
  • Account & Billing

    • Account API
    • API Keys
    • Subscriptions
    • Organizations

List Marine Fuel Ports

Get a list of all available marine fuel ports with their details and capabilities.

Endpoint

GET /v1/marine-ports

Authentication

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

Authorization: Token YOUR_API_KEY

Query Parameters

ParameterTypeDescription
regionstringFilter by geographic region (Asia, Europe, Americas, Middle East)
countrystringFilter by country code
major_portsbooleanReturn only major bunkering hubs

Response

{
  "status": "success",
  "data": {
    "ports": [
      {
        "code": "SGSIN",
        "name": "Singapore",
        "country": "Singapore",
        "region": "Asia",
        "major_port": true,
        "coordinates": {
          "latitude": 1.2966,
          "longitude": 103.7764
        },
        "fuel_services": ["MGO_05S", "VLSFO", "HFO_380", "HFO_180"],
        "trading_hours": "24/7"
      }
      // ... more ports
    ],
    "count": 8,
    "filters": {
      "region": null,
      "country": null,
      "major_ports_only": false
    }
  }
}

Examples

Get all ports

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

Get Asian ports only

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/marine-ports?region=Asia

Get major ports only

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/marine-ports?major_ports=true

Response Fields

  • code: Unique port identifier (e.g., SGSIN for Singapore)
  • name: Port name
  • country: Country where port is located
  • region: Geographic region (Asia, Europe, Americas, Middle East)
  • major_port: Boolean indicating if this is a major bunkering hub
  • coordinates: Latitude and longitude of the port
  • fuel_services: Array of available fuel types at this port
  • trading_hours: Operating hours for bunker operations

Need More Ports?

This endpoint returns our 8 major bunkering hubs with continuously updated prices. If you need broader coverage, our Ship&Bunker Data Connector provides access to 218 ports across Americas, EMEA, and Asia-Pacific.

CoverageThis EndpointBYOS Connector
Ports8 major hubs218 ports
Regions43 (detailed)
Fuel Types43 (VLSFO, MGO, IFO380)
Data SourceDirect feedsYour Ship&Bunker subscription

The BYOS (Bring Your Own Subscription) connector lets you connect your existing Ship&Bunker subscription and access all 218 ports via API.

Learn more about the Ship&Bunker Data Connector →

Last Updated: 7/13/26, 10:18 AM
Prev
Marine Fuel API
Next
Get Port Details with Prices