REST + WebSocket API

Build on Bulugo's
maritime fuel data

Access 7 years of bunker pricing, 14,904 ports, and real-time quote flow. One API, everything you need.

Get API KeyView Documentation
API Overview

Everything the market needs

Three core APIs — bunker prices, port data, and the quote engine.

📊

Bunker Prices

Historical and live bunker fuel prices across 12 key ports. VLSFO, HSFO, MGO, LSMGO — all fuel grades covered.

🌍

Port Data

14,904 ports with supplier availability, fuel types, delivery methods, and operational details.

⚡

Quote Flow

Programmatic quote requests and responses via REST or WebSocket. Build your own procurement interface.

Quick Start

Up and running in minutes

Simple REST endpoints. JSON responses. No surprises.

GET /v1/prices

Fetch bunker prices

Get current and historical bunker fuel prices for any supported port. Filter by fuel type, date range, and delivery method.

Returns spot prices, 30-day averages, and price trends — updated every 15 minutes for live ports.

terminal
# Get VLSFO prices in Singapore
curl "https://api.bulugo.com/v1/prices?port=SGSIN&fuel=VLSFO" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "port": "SGSIN",
  "fuel": "VLSFO",
  "price": 628.50,
  "currency": "USD",
  "unit": "MT",
  "avg_30d": 632.10,
  "trend": "down",
  "updated_at": "2026-02-17T10:45:00Z"
}
terminal
# Search ports with VLSFO availability
curl "https://api.bulugo.com/v1/ports?fuel=VLSFO&region=asia" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "total": 847,
  "ports": [
    {
      "code": "SGSIN",
      "name": "Singapore",
      "suppliers": 34,
      "fuels": ["VLSFO", "HSFO", "MGO"],
      "live_pricing": true
    }
  ]
}
GET /v1/ports

Search port data

Query our database of 14,904 ports. Filter by region, fuel availability, supplier count, and delivery capabilities.

Each port includes supplier count, available fuel types, and whether live pricing is available.

POST /v1/quotes

Request a quote

Submit a programmatic quote request. Our matching engine returns competitive quotes — typically in under 60 seconds.

Subscribe to WebSocket events for real-time updates as suppliers respond.

terminal
# Request a quote
curl -X POST "https://api.bulugo.com/v1/quotes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "port": "SGSIN",
    "fuel": "VLSFO",
    "quantity_mt": 500,
    "delivery_start": "2026-03-25",
    "delivery_end": "2026-03-31"
  }'

# Response
{
  "quote_id": "qt_8f3k2m9x",
  "status": "matching",
  "suppliers_contacted": 8,
  "ws_channel": "quotes.qt_8f3k2m9x"
}
Rate Limits

Built for scale

Generous limits on every tier. Need more? We'll work with you.

Free

100

requests / day

Prices & ports only

Pro

10K

requests / day

All endpoints + WebSocket

Enterprise

∞

custom limits

Dedicated infrastructure

Authentication

Simple bearer token auth

All API requests use bearer tokens. Generate keys from your dashboard, rotate anytime, and set granular scopes per key.

  • 1Sign up and request API access
  • 2Generate an API key from your dashboard
  • 3Include the key in your Authorization header
  • 4Set scopes: read-only, quotes, or full access
authentication
# All requests use Bearer auth
curl "https://api.bulugo.com/v1/prices" \
  -H "Authorization: Bearer bul_live_sk_..."

# API keys have scopes
# bul_live_sk_... → production key
# bul_test_sk_... → sandbox key

# OpenAPI spec available at:
# https://api.bulugo.com/v1/openapi.json

# Interactive docs (Swagger UI):
# https://api.bulugo.com/docs
Get Started

Start building today

Free tier includes 100 API calls per day. No credit card required.

Get API KeyRead the Docs