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 це залишок на борту (ROB) — число, яке визначає, скільки ви насправді можете взяти, і те, яке більшість флотових систем змушені запитувати в капітана.

Запити та котирування

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 це те, наскільки впевненим був парсер, коли зчитував лист постачальника. Нижче 0.9 на нього подивилася людина.

Публічна цінова дошка

Відкрита, ключ не потрібен, план не потрібен.

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

Помилки