API dati

Accesso

Incluso in Fleet, Enterprise e Fleet. Emetti una chiave in impostazioni; le chiavi iniziano con bfp_.

Una chiave può essere emessa su qualsiasi piano e risponderà 402 finché il piano non la include — così l'integrazione viene costruita una volta e inizia a funzionare quando il piano cambia, anziché restare bloccata fino ad allora. Fleet prevede 50,000 chiamate al mese, Enterprise 500,000.

La tua flotta

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 è il remaining on board — il numero che determina quanto puoi effettivamente caricare, e quello che la maggior parte dei sistemi di flotta deve chiedere a un comandante.

Richieste e quotazioni

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 è quello su cui confrontare. La cifra principale non è ciò che paghi: esclude il barge fee, il costo dei termini di pagamento e la tua posizione creditizia con quel fornitore, e lo scarto tra i due è abitualmente da $10 a $40 a tonnellata. Ordinare i fornitori per usdPerMt porta sistematicamente a scegliere quello sbagliato.

extractionConfidence indica quanto era sicuro il parser quando ha letto l'email del fornitore. Sotto 0.9 una persona l'ha esaminata.

Il price board pubblico

Aperto, senza chiave, senza piano.

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

Errori