API de Datos

Acceso

Incluida con Fleet, Enterprise y Fleet. Emita una clave en ajustes; las claves empiezan por bfp_.

Se puede emitir una clave en cualquier plan y responderá 402 hasta que el plan la incluya — de modo que la integración se construye una sola vez y empieza a funcionar cuando cambia el plan, en lugar de quedar bloqueada hasta entonces. Fleet son 50,000 llamadas al mes, Enterprise 500,000.

Su flota

GET https://bunkerfuelprices.com/api/v1/data/fleet

curl https://bunkerfuelprices.com/api/v1/data/fleet \
  -H "Authorization: Bearer bfp_YOUR_KEY"

{
  "organisation": "Aegean Shipping",
  "vessels": [
    {
      "imo": "9876543", "name": "MV EXAMPLE", "segment": "commercial",
      "dwt": 82000, "consumptionMtPerDay": 28.5, "serviceSpeedKts": 13.2,
      "scrubber": false,
      "position": {
        "lat": 1.265, "lon": 103.82, "speedKts": 11.4, "courseDeg": 87,
        "destination": "SGSIN",
        "nextPort": { "name": "Singapore", "locode": "SGSIN" },
        "etaAt": "2026-09-02T06:00:00.000Z",
        "observedAt": "2026-08-30T13:31:00.000Z", "source": "aisstream"
      },
      "rob": { "vlsfoMt": 640, "mgoMt": 95 }
    }
  ]
}

rob es el remaining on board — la cifra que decide cuánto puede levantar realmente, y la que la mayoría de los sistemas de flota tienen que pedir a un capitán.

Solicitudes y cotizaciones

GET https://bunkerfuelprices.com/api/v1/data/quotes?days=90

{
  "requests": [
    {
      "ref": "BFP-7K2M",
      "port": { "name": "Singapore", "locode": "SGSIN" },
      "grade": "VLSFO", "quantityMt": 1200,
      "status": "comparing",
      "quotes": [
        {
          "usdPerMt": 784.50,
          "allInUsdPerMt": 799.10,
          "bargeFeeUsd": 8500,
          "paymentTermDays": 30,
          "creditAdjUsdPerMt": 2.10,
          "basis": "delivered", "validUntil": "2026-08-30T17:00:00.000Z",
          "extractionConfidence": 0.96
        }
      ]
    }
  ]
}

allInUsdPerMt es la cifra sobre la que comparar. El importe principal no es lo que paga: excluye la tarifa de barcaza, el coste de las condiciones de pago y su posición crediticia con ese suministrador, y la diferencia entre ambas suele ser de $10 a $40 por tonelada. Ordenar a los suministradores por usdPerMt elige de forma fiable al equivocado.

extractionConfidence es cuán seguro estaba el parser al leer el correo del suministrador. Por debajo de 0,9 una persona lo ha revisado.

El tablón de precios público

Abierto, sin clave, sin plan.

curl "https://bunkerfuelprices.com/api/v1/prices?grade=VLSFO&limit=50"

Errores