Data API

Πρόσβαση

Περιλαμβάνεται με Fleet, Enterprise και Fleet. Εκδώστε ένα κλειδί στις ρυθμίσεις· τα κλειδιά ξεκινούν με bfp_.

Ένα κλειδί μπορεί να εκδοθεί σε οποιοδήποτε πρόγραμμα και θα απαντά 402 μέχρι το πρόγραμμα να το περιλαμβάνει — έτσι η ενσωμάτωση κατασκευάζεται μία φορά και αρχίζει να λειτουργεί όταν αλλάξει το πρόγραμμα, αντί να είναι μπλοκαρισμένη μέχρι τότε. Το Fleet είναι 50,000 κλήσεις τον μήνα, το Enterprise 500,000.

Ο στόλος σας

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 είναι το υπόλοιπο επί του πλοίου (remaining on board) — ο αριθμός που καθορίζει πόσο μπορείτε πραγματικά να παραλάβετε, και εκείνος που τα περισσότερα συστήματα στόλου πρέπει να ζητήσουν από έναν πλοίαρχο.

Αιτήματα και προσφορές

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 είναι εκείνο βάσει του οποίου πρέπει να συγκρίνετε. Ο κύριος αριθμός δεν είναι αυτό που πληρώνετε: εξαιρεί το τέλος της φορτηγίδας, το κόστος των όρων πληρωμής και την πιστωτική σας θέση με εκείνον τον προμηθευτή, και η διαφορά μεταξύ των δύο είναι συνήθως $10 έως $40 ανά τόνο. Η ταξινόμηση των προμηθευτών κατά usdPerMt επιλέγει αξιόπιστα τον λάθος.

extractionConfidence είναι το πόσο σίγουρος ήταν ο parser όταν διάβασε το email του προμηθευτή. Κάτω από 0.9 το έχει εξετάσει ένα άτομο.

Ο δημόσιος πίνακας τιμών

Ανοιχτός, χωρίς κλειδί, χωρίς πρόγραμμα.

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

Σφάλματα