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

Maritime Fuels

Premium maritime fuel bundle endpoints.

Endpoints

MethodEndpointDescription
GET/v1/maritime-fuels/bundleCurrent maritime fuel bundle
GET/v1/maritime-fuels/historicalHistorical maritime fuel bundle

Bundle

curl "https://api.oilpriceapi.com/v1/maritime-fuels/bundle" \
  -H "Authorization: Token YOUR_API_KEY"
{
  "status": "success",
  "data": {
    "bundle": "maritime_fuels",
    "updated_at": "2026-07-15T14:30:00.000Z",
    "prices": [
      {
        "code": "VLSFO_SGSIN_USD",
        "port_code": "SGSIN",
        "fuel_type": "VLSFO",
        "price": 615.25,
        "currency": "USD"
      }
    ]
  }
}

Historical

curl "https://api.oilpriceapi.com/v1/maritime-fuels/historical?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Token YOUR_API_KEY"

How It Differs

SurfaceUse When
/v1/prices/marine-fuels/*You need the standard current/historical marine fuel price API
/v1/bunker-fuels/*You need bunker comparison, spreads, or export workflows
/v1/maritime-fuels/*You need the premium bundle shaped for maritime data products
/v1/marine-ports/*You need port metadata

Error Cases

StatusWhen
400Invalid date or filter
401Missing or invalid API key
403Premium maritime entitlement missing
402Plan/quota issue
Last Updated: 7/16/26, 1:53 PM
Prev
Bunker Fuels